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And now, a word from the sponsors of 
The .EXE Software Development Awards. 


lS ad 
From one kind of dog to another: 
Jules May’s ‘Thanks for Nothing’ Award. 
ere 
All this and some cracking comms too! 
A definitive fax programming series begins. 
SS ae | | seen cae ay 


There’s more to W4WG than a game of Hearts. 


System Architect | 


the CASE tool built for the real world | 


Many CASE tools appear to have been produced for a highly 
unreal world where the tool is so expensive only a chosen few 


Policy Filling and Gotlection 


can use it. System Architect is different - it is an affordable CASE | 
tool for the real world, where developers have to use it every 

day. Since its introduction in 1988 System Architect has offered 
all the features of higher priced tools - and several additional 


ones - at a fraction of the 
cost. Over 12,000 users at 
3,000 installations world- 
wide contribute to its 


REATE INDE 


further development by [CRATE met 
providing Popkin with 
their experiences and 
observations. 


‘We take your advice 
because we know its real. Then we incorporate it and 
feed it back to you in real-world solutions and new 


product innovations." Jan Popkin, Popkin Software & Systems Inc. 


High Performance, Easy-to-use 
System Architect works on PCs running MS Windows or OS/2 
PM. It is so user friendly that from day one you can work with it 
and be productive. It comes with an integrated data dictionary 
that can be customised to meet your needs. Project personnel 
can easily share information both on and off a network. It is the 
perfect solution for hands-on developers whose livelihood 
depends on their ability to produce quality results. 


Freedom of choice 
System Architect leaves you free to work the way you want to. 
Your application may be targeted for PC, Client Server or Main- 
frame environments. You may choose from multiple method- 
ologies such as Yourdon/DeMarco, Gane & Sarson, Information 
Engineering, SSADM, Ward & Mellor (real-time); and for 
OOA/OOD, Booch, Shlaer/Mellor or Coad/Yourdon. 


Powerful options 
System Architect is continually growing in functionality. 
Optional modules available include: 
Schema Generator - Translates entity models from the 
encyclopedia into schema for DB2, Oracle, Ingres, SQL Server, 
Rdb, PROGRESS, Paradox, SQL Base, AS400, Interbase, OS/2 DBMS. 
dBASE! 11, XDB, SYBASE and Informix. It generates Windows 
DLGs and C type data definitions or COBOL data structures. 


Real Techniques and Methods Ltd 
118-120 Warwick Street Leamington Spa CV32 4QY 


Tel: 0926 450858 Fax: 0926 422165 


Built by engineers, for engineers 


‘Youtdon-DoMarco 


Screen Painter - Develops screens for GUI 
or character based applications, which are 
automatically populated from your System 
Architect data dictionary/encyclopedia. | 
Generates MSWindows dialogues and | 
Microsoft or Microfocus COBOL Screen 

Sections and associated working storage 

definitions or .H files. | 
Object Oriented Analysis & Design - Supports Booch 91, 
Coad/Yourdon and Shlaer/Mellor. 

Advanced Documentation Facility - Enables the user to 
query the System Architect database files. Documents can then 
be customised in ASCII format or Rich Text Format files and 
printed hardcopy produced. Pre-formatted documents can also 
be displayed or printed. 

Reverse Data Engineer - Increases productivity by effortlessly 
creating Entity Relation Diagrams and dictionary entries from 
existing databases or schema. Will also create GUI dialogues and 
create or capture Windows style menus. 


If you need a high performance, flexible, effective and affordable 
CASE tool, you've found it! System Architect has the power 
to handle even the most complex applications. In addition to its 
open architecture, System Architect has automated 

documentation, an extensible data dictionary, rules and balancing, ° 
requirements traceability, custom reporting, auto levelling and i 
CRUD matrices. 


Our customers know the market - and they tell us 
that there is no easier-to-use, more powerful, more 
flexible, more affordable CASE tool anywhere. 


For further details or to arrange a demonstration please call us 
on: 0926 450858 or fax us on: 0926 422165, or come to 
one of our regular System Architect seminars - call for dates. 
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Editorial 
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From time to time, we offer to copy the PC program code 
described in‘an article onto diskette for our readers. In this 
case, please send a blank, formatted disk with a self-ad- 


above. We can copy both 5.25" and 3.5" disks. 
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If they can’t agree on byte ordering, what hope for float arrays? 
ASN.1 describes data in a machine-independent way. 
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IC 
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Peter Collinson investigates networked file systems. 
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Another Golden Oldie: Verity presents a new language. 


96 


.EXE Magazine, Vol 8, Issue 2, July 1993 1 


———ee SOAPBOX eee 27 


Intel Outside 


Intel is king of the PC industry. But for how long? 


Three months ago we witnessed the launch of a new 
microprocessor. Mind you, this was no ordinary microproc- 
essor. This was the Pentium, destined to take Intel’s x86 
architecture well into the late 90s. Destined to give levels 
of price/performance as yet unheard of, opening the flood- 
gates to software of immense complexity and new types of 
application... All from a core architecture which was first 
devised in 1978, when Sid Vicious was doing his thing. 

While we are willing to tell 
others how quickly we adopt in- 
novative new technology, fact is, 
we're a stubborn lot, opting for 
compatibility rather than seeking 
out better (although, possibly in- 
compatible) alternatives. We are 
still writing 16-bit applications; 
still juggling 64 KB segments and 
still using an operating system 
which gives only 640 KB of con- » 


run our code. Of course, I’m 
speaking of the PC market and . 
MS-DOS. With over 100 million | 
machines world-wide, it isn’t sur- -Y 
prising we’re reluctant to change. 
The possibility of writing soft- 
ware for the masses has inhibited \~ 
the evolution of the PC. None of + 
Darwin’s theory applies here - 7: 
this is survival of the couch po- \ *- 
tato. ‘ 

But things are about to change. 
Despite the phenomenal success * 
of Window 3.x, it is only a 16-bit, single-threaded GUI, 
sitting on top of good old DOS - a DOS enhancer. But its 
successor, Windows NT, is likely to change both the 
software and the hardware side of the PC industry for good. 
For the hardware designer it offers a break away from the 
x86 architecture. And for software developers, there’s a flat 
32-bit address space in which to write multi-threading 
applications. 

Remember the ACE consortium? Set up by Microsoft, 
SCO and MIPs to promote software compatibility between 
RISC and CISC architectures across Windows NT and SCO 
UNIX platforms. It was generally perceived as an anti-Intel 
alliance. We haven’t heard much from ACE recently - but 
surely the new MIPs R4000 and DEC Alpha PCs are its first 
protégés. 

Notice I said MIPS and DEC PCs, not workstations. The 
workstation has always been synonymous with ‘high-end’, 
high performance UNIX machines. The PC, on the other 
hand, is a low-cost general purpose machine. Not only do 
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workstations command a high price tag, the software they 
run tend to fit into the mega-bucks price bracket. By 
comparison, PC software is cheap, period. 

If NT is successful, the division between workstation and 
PC will become disappear. Users won't be forced to pay a 
premium for running the R4000 or Alpha version of their 
favourite DTP, word processing, database or spreadsheet 
package. Already the big names, including Lotus, WordPer- 

_ fect and Borland are committed 
to releasing NT versions of their 
packages. 

So how will the launch of NT 
affect Pentium sales? Will there 
be a mass exodus from the Intel 
camp to either DEC or MIPs? 
Intel says it isn’t concerned. It 
plans to maintain its dominance 
in the mass market - with what, 
in effect, is an inferior product. 
The people who will initially 
buy these machines are looking 
for cutting-edge performance 
(eg for CAD). Why would they 
opt for a 66 MHz Pentium PC 
when a similarly configured 150 
. MHz DEC Alpha will cost about 
«the same? Intel maintains that 
the overall cost of manufactur- 
- ing a 150 MHz Alpha chip is far 
‘more than that of the 66 MHz 
\,,- Pentium. But since Intel is only 


'«*4 there is still time for DEC and 
MIPs to establish themselves. The designers at Intel would 
be foolish to think their domination of the mass market will 
continue unchallenged. 

Of course, there has always been competition. In the 
mid-1980s the 8086 and the NEC V20 fought over the PC 
market. A direct attack on the 486 is imminent with the 
arrival of AMD’s long awaited 486-clone, despite Intel’s 
successful copyright suit against AMD. The AMD386 was 
faster and cheaper than the Intel386. We expect history will 
repeat itself. Cyrix, too, is hacking away at Intel’s virtual 
monopoly of the x86 market. But both companies plan 
Pentium-compatible processors for the future, the most 
serious threat to Intel is from MIPs and DEC. 

I believe we are we witnessing the end of Intel’s reign 
over the PC industry. The time for abandoning the x86 
architecture is long overdue. We now have 64-bit proces- 
sors and 32-bit operating systems. Why restrict our software 
to 16-bit compatibility? 
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ie 
Serer era , !>385'5 shipping 10,000 units this year, 
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(EXE) 


| C Asynch Manager £145 
| CComms Toolkit £215 
| COMM-DRV £145 
| Essential Comms £215 
Greenleaf CommLib 4.0 £205 
| Silvercomm “C" Asynch £135 
| Database 
|) Btrieve £365 
| c-tree Plus 6.0C £565 
| CodeBase 5.0 £240 
| D-ISAM £325 
| d-tree £490 
| DataBoss £520 
| Greenleaf Database Library £155 
|| Paradox Engine & DFX 3.0 £125 
| POET SDK 2.0 £360 
}) tree £295 
| Raima Data Manager £305 
‘| Raima Object Manager £305 
|, SoftFocus Btree/ISAM £75 
| Sycero.C Network £895 
| Watcom SQL Developer's £295 
| Graphics & GUI 
| Accusoft Image Format Lib £370 
| dGE £205 
| Essential Graphics Chart £130 
| Essential Graphics Kernel £135 
| Essential Graphics GUI £99 
GraphiC 6.1 £305 
| graphics-MENU & Data Entry £205 
/ GX Graphics 2.0 £155 
HALO Professional 2.0 £245 
| MetaWINDOW 4/32 £185 
MetaWINDOW/Plus 4/32 £250 
MetaWiINDOW/Premium 4/32 £310 
 object-Menu £305 
| PCX Toolkit 5.0 £155 
) PCX-Lab £100 
| Real-Time Graphics & M/CT £185 
T-Windows £240 
TEGL Windows Toolkit II 2.2 £80 
zApp for DOS Graphics 2.0 £255 
Zinc 3.5 for DOS £345 
Math & Scientific 
C/Math Toolchest & Grafix £45 
Huge Virtual Array & NAT £215 
Linpack.h++ w/Source £429 
Math.h++ w/Source £257 
Matrix.h++ w/Source £343 
MIRACL. £39 
Science & Eng Tools 8.0 £115 
| Printer 
Baby Driver Kernel £185 
BGI Printer Driver Toolkit £105 
GX Printer £240 
SLATE £260 
TesSeRact Printer Control Sys £45 


Aztec Embedded C86 
Borland C++ 3.1 
Borland C++ & AFX 3.1 
Microsoft Visual C++ Std 


Microsoft Visual C++ Prof £222 | 
MS QuickC 2.5 £50 | 
MS QuickC & QuickAsm £83 | 
Topspeed C Prof £165 
Topspeed C++ Prof £165 
Turbo C++ 3.0 £59 


Turbo C++ Visual Ed. for Win 


Watcom C 9.0 £320 | 
Zortech C++ 3.1 £185 § 
High C/C++ 386 3.1 £555 
NDP C (386) £445 
SVS C3 ANSI-C (386) £310 
Watcom C/386 9.0 


Borland C++ for OS/2 


DOS EXTENDERS | 


NEW PHAR LAP 286/D0S-EX TENDER 
SDK 3.0 now includes Phar Lap's new 


| 286/VMM virtual memory manager and fully 
 _ supports Visual C++ Professional and © 
CodeView, Also supports Microsoft C/C++ | 
(V6.1, 6.0 & 7.0), Borland C++ andMS |, 
Fortran 5.1 - ONLY £380 


NEW PHAR LAP 386IDOS-EXTENDER 
SDK 5.0 lets you use the Microsoft i 
Windows NT 32-bit C/C++ compiler for 32- 
bit Extended-DOS development. It offers | 
the full functionality of the 16-bit Microsoft 
| C/C++ DOS run-time libraries, including 
» graphics. It also includes a new source level | i 
debugger - ONLY £395 


Phar Lap 286IDOS-Ext SDK 
Phar Lap 386IDOS-Ext SDK 


£380 


| Outline Control for hierarchical list-boxes as 


C-Scape 4.0 
Cindows Toolchest 
Greenleaf Datawindows 3.0 
MEWEL Window System 
Object Professional for C++ 
Panel Plus II 

TCXL-DOS 6.1 

Turbo Vision 1.1 

Turbo Vision Dev Toolkit 2.0 
Vermont Views 

Vermont Views Plus 

zApp for DOS Text 


£360 

£45 
£220 
£175 
£165 
£260 

£79 

£25 
£105 
£350 
£595 
£255 


General & Systems Libraries 


C Tools Plus/6.0 

CAD/CAM Dev Kit/2D Personal 
CodeRunner 

Heap Expander 3.0 

Hold Everything 

Interwork 

MoreHeap 

MTASK 

Multi-C w/Source 

PDK #1, #2, #3 

PowerSTOR 

Resident-C 

TesSeRact Compression Sys 
TesSeRact TSR Dev Sys 2.0 
TG Professional (CAD/CAM) 
Tools.h++ w/Source 

TSRs and More 

VMData 


Tools 
C-DOC 
C-Vision 
Clear+ for C 
CodeCheck Personal 
MKS LEX & YACC 
PC-Lint 
PCYACC Personal 
SourcePrint+ Date es 0 


Ei 


£115 
£375 
£150 
£130 
£130 
£205 
£110 
£215 

£39 

£95 

£99 
£160 

£39 

£79 
£395 
£257 
£115 
£370 


£150 

£90 
£135 
£250 
£240 

£85 
£250 
£190 


VISUAL BASIC FOR WINDOWS: 
NEW VISUAL BASIC 3.0 FOR WINDOWS 


STANDARD now includes the Access 1.1 


Database Engine and full OLE 2.0 support. 


The Access engine provides robust multi- 
user support, true transaction processing, 


optimistic & pessimistic locking, support for 
a wide range of data types including sound, 
video, OLE objects, pictures etc, distributed 
Joins, updatable queries, query optimisation 


and support for Access, FoxPro, dBase, 

Paradox and Btrieve files. The engine is 
accessed visually through a new Data 

Control which handles the query and new 
data-aware controls such as TextBox, 


CheckBox, Picture etc which can be bound 
toa query without writing code. ONLY £95 


(upgrade from VB2 Standard for £39). 
NEW PROFESSIONAL EDITION adds a 


programmatic data-access layer to control 


the engine directly (variables of type 
Database, Table, Dynaset etc may be 


declared in Visual Basic), full ODBC support 
including scrollable cursors and drivers for 

SQL Server and Oracle, Crystal Reports for 
Visual Basic (with royalty-free print engine), 


additional data-aware controls (Masked 
Edit, 3D Panel & 3D Check Box), anew 


in File Manager, and a new version of the 

Control Development Kit for creating data- 
aware custom controls. ONLY £222 

(upgrade from VB2 Professional for £59). 


C Comms ToolkitWindows. 
COMM-DRV 
CrystalComm for Windows 
Greenleaf Comm++ 
Greenleaf CommLib Pro 


Btrieve for Windows 
CodeBase 5.0 

Paradox Engine & DFX 3.0 
POET SDK 2.0 

Q+E Database Library 
Raima Data Manager 
Raima Object Manager 
Watcom SQL for Windows 


Accusoft Image Format Lib 
C++/Views 2.1 

Control Palette 2.0 * 
Data Entry Workshop 


C & C++ FOR WINDOWS | 


£265 
£145 
£130 
£155 
£325 


£365 
£240 
£125 
£360 
£295 
£380 
£305 
£295 


£370 
£360 
£110 
£130 


for Windows is the most 

significant announcement this month, both 

/ for its influence and expected sales. The 

| Access Engine is the most attractive new 

i feature - a fully featured relational database 

} engine which can be accessed either 

}| visually with data-aware custom controls 
and the data control or directly in code by 

) declaring variables of types such as 
Database, Table, Dynaset, Querydef etc 

| and performing operations on them. 12 

| months ago, Microsoft had minimal 

| presence in the database market, whereas. 

| in 12 months time, the Access engine could 

) be the most widely used database tool on 

} Windows. Let's wait and see. 

| In the longer term, the support for OLE 2.0 

} will probably be more significant. It will 
enable anyone to write applications which 
can incorporate OLE 2.0 applications such 
as word processors and spreadsheets, OLE 
2.0 Automation is the magic bit - it lets you 

} send messages, set properties or execute 


Prices do not include VAT or other tocal 
taxes but do include delivery in mainland 
UK . Please check prices at time of order 
as ads are prepared some weeks before 
publication. This page lists some 
products — call us for a complete 

price list. ORDER BY PHONE WITH 

YOUR CREDIT CARD 


(0364) 654100 


FAX: (0364) 654200 


PROGRAM 
too 
Ada 
) Basic Cc 
y C++ Cobol 
| Comms Cross Dev 
| Custom Controls Database 


Assemblers 

| 

Debuggers Dos Extenders 
| 


| simply declare a variable of type Object in 

} your program, set it to an OLE object such 

} as Word.Document and control it directly. If 
an OLE 2.0 object supports in-place editing 

) as well as OLE Automation, it is effectively a 

} control. This will open a massive market for 

| OLE 2.0 developers - assuming it all works 
as well as Microsoft says that it does! 


I asic 


Compilers & Interpreters 


Editors Fortran 
) Graphics GUI 
Linkers/Locaters Lisp 
Logo Memory Management 
Modula-2 Multi-tasking 
Pascal Prolog | 
Rexx Scheme | 

i 


BBC BASIC-86 Plus £75 
I Smalltalk SQL CA-Realizer (Win) £190 
) Version Control Visual Programming GFA-BASIC for DOS £85 
) Windows Xbase GFA-BASIC for DOS Compiler £42 
We stock many items for which there Seer for Woe ier ole 
is no space in these advertisements. [Rana £110 


TrueBASIC 3.0 


Visual Basic 3.0 for Win Std £95 

: (i Hi MS Visual Bas Basic for DOS Std £95 
eh bane ae ae MS Visual Basic for DOS Prot £202 

comms Lib/Win 
Newel a el £80 Roe oe OS wl 
hee re or inceys se PDQ Comm £65 | 

gility i | 
Birieve for Windows £365 Birieve 5.1 eal 

‘ db/Lib Prof £140 

CodeBasic £145 E-Tree Plus $165 | 
ObjecTrieve Prof 2.01 £395 i i 
Q+E Database/VB £135 Graphics QuickScreen £105 | 
Q+E Multilink, VB £295 Graphics Workshop £105 | 
Raima Data Manager £380 GraphPak Pro £99 ff 
VB/ISAM MU £150 GX Graphics 2.0 £155 
Visual/db £115 HALO Professional 2.01 £245 | 
3-D Gizmos £80 Compression Plus £130 | 
3-D Widgets (1/2/3) £69 Compression Workshop £110 
ButtonTool & EditToo! £69 Microhelp Muscle/DOS £155 | 
ChartBuilder for VB £75 PDQ £110 | 


Printer Plus 
ProBas 5.5 
QuickPak Prof 4.1 


Control Palette 2.0 
Custom Control Factory 
MS Visual Control Pack 


£185 | 
£165 
£145 | 


QuickPak Pro for Windows. £145 QuickPak Scientific 3.0 £105 
SpyWorks-VB £120 QuickScreen 4.0 £105 | 
VBAssist £79 Science & Eng Tools 8.0 £80 
VBTools/Win 2.0 £145 TSRific £80 | 
Visual Architect £205 LOW P R ICES 

3D Graphic Tools £90 s 
GUI Assist £350 MICROSOFT « BORLAND 
Microhelp Muscle/Win £155 


PCX Toolkit for Windows 
Spellcheck/VB 

VB Compress Pro. 
VBXxRef Utility 


249 | Microsoft Access 
Microsoft Cobol 5.0 
Microsoft Delta 
Microsoft Fortran 5.4 
Microsoft Fortran Power Station 
Microsoft FoxPro 2.5 
Microsoft FoxPro for Windows 


DataTable (special offer) £75 

Drover's Prof Toolbox 3.0 £305 

Essential Graphics Chart £300 Ras VII Beads CE WIR Sie 
crepe eae || MS Visual Basie for Win Prof 
Graphics Server SDK £205 Microsoft Visual C++ Std 

Mens Feld £255 || Microsoft Visual C++ Prof 

MS Visual Control Pack £69 Microsoft Windows 3.1 

Out of Controls w/Source £270 MS Windows SDK 3.1 

PCX Toolkit for Windows £155 Borland C++ 3.1 

ProtoGen 3.0 (special offer) £75 Borland C++ & AFX 3.1 
ProtoView 3.3 (special offer) £149 Borland Pascal with Objects 7.0 
Win/Sys Library £105 dBase IV 1.5 

Wins+ £185, Baretiox moans, & DFX 3.0 
Windows Charting Tools £300 . 

WindowsMaker Pro 4.0 £560 Lee CH visual Beton ye 
ZApp for Windows 2.0 £255 Turbo Pascal for Windows 1.5 
zApp for Windows NT 2.0 £315 Paradox 4.0 £415 
Zinc 3.5 for Windows £345 
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AM386 Attacked 
Intel is continuing its legal assault on 


AMD. A Court ruling six months ago 
delayed introduction of the AM486. 
Now Intel has won the next round. 
The Californian Court of Appeals for 
the Sixth District has recently ruled 
against AMD over its rights to In- 
tel386 technology, used in the 
AM386 microprocessor. Intel is now 
planning a separate federal suit 
against the AM386. Intel predicts 
damages against AMD will be over} 
$600 million. 


60 days to go... 

On 24th May Microsoft formally un- 
veiled Windows NT. The first batch is 
expected to ship within 60 days of this 
announcement. In his speech, Bill 
Gates suggested that: {Windows NT) 
represents a fundamental change in 
the way all companies can address 
their computing requirements.’ Ex- 
periencing such a change will set you 
back a cool £399 (£249 upgrade 
Srom Windows 3.x or OS/2). ; 


Icicle 

New York based ImageSoft has put 
together a library of public domain 
and shareware C++ source called ISCL 
(pronounced Tcicle’). It includes the 
GNU 386 C++ compiler, a comms 
library, maths and matrix classes, 
DPMI programming kit, classes for| 
Btrieve and Paradox and a C++ class 
library for building GUIs. ISCL costs 
£85 from SystemStar (0992 500919). 


Higher C 

MetaWare has introduced a new ver- 
sion of its High C/C++ DOS/Windows 
compiler which has been optimised 
for the Pentium. It features instruc- 
tion scheduling, inlining and loop 
strength reduction global optimisa- 
tions. High C/C++ V3.1 for Extended 
DOS and Windows 3.1 costs $795. 
MetaWare is on 0101 408 4296382. 


VBW support in GFA 

The recently introduced GFA-Basic 
for Windows V4.3 offers enhanced 
support for VBW programmers. Un- 
like VBW, GFA-Basic is able to gen- 
erate native compiled code for writ- 
ing standalone executables and 
DLLs. One of the new features is VB, 
acommand which gives a GFA-Basic 
DLL the ability to call a routine in a 
VBW executable which loads it. The 
GFA-Basic Interpreter costs £170; the 
compiler, £42.55. Both are available 
direct from GFA Data Media (0734 
794941). 


MS Database Tools 


Microsoft is offering FoxPro devel- 
opers three new tools. The Distribu- 
tion Kit is available for both DOS and 
Windows versions of FoxPro, allowing 
developers to compile DOS or Win- 
dows FoxPro applications for royalty- 
free distribution. It comes with a 
version of Setup Wizard, the Windows 
Help Compiler, an online version of 
The Windows Interface Design Guide 
and a run-time version of Microsoft 
Graph. Both the DOS and the Win- 
dows versions are priced at £199 each. 

The Library Construction Kit enables 
C programmers to extend FoxPro by 
writing Windows FoxPro Linked Li- 
braries (.FLLs) or DOS-based FoxPro 
libraries (.PLBs) which are source code 
compatible. Microsoft claims that a 
.PLB may be compiled under Windows 
with minimal change. Also new: event- 
processing books, low-level key- 
board/mouse control and direct 
database access. The FoxPro Library 
construction kit costs &395. 

Microsoft's other Windows database 
has been upgraded. New features to 
Access V1.1 include ODBC support for 
Oracle and Sybase and the ability to 
read and write FoxPro V2.0 and V2.5 
data and index files ‘on the fly’. Also 
available is the Access Distribution Kit 


which comes with a run-time version 
of Microsoft Access, for royalty-free 
distribution of applications. 

Microsoft is asking £14.95 to upgrade 
existing Access users to the new re- 
lease. The Access Distribution Kit costs 
£395. Microsoft is on 0734 270000. 


Maths Class 


There’s a new version of Meijin++, 
the C++ numeric class library from 
Network Integrated Services. Bearing 
in mind I’m someone who flunked 
Maths A’Level, I won’t attempt to ex- 
plain all its features. But I did recognise 
a few of the classes it offered. From the 
comprehensive list I encountered a 
few familiar acquaintances like Euler 
and Newton-Raphson; old foes among 
the trigonometric, hyperbolic and 
polynomial functions and, from glori- 
ous Stats, the Normal, 77, Poisson and 
Binomial distributions. 

Meijin++ also provides: linear regres- 
sion, Fast Fourier transform, filtering, 
moments and matrix operations. And 
some linear sorts and container classes. 

All of this needs documentation - 940 
pages worth and 200 sample pro- 
grams, along with case studies and 
maths theory. The DOS version is 
priced at £749 ($1196 for UNIX) from 
Hypersoft (0273 834596). 


Boost for OS/2 


IBM has introduced a new version of OS/2 to answer some of the criticism 
of the V2.0 release. First, Windows 3.1 support has been added. If you recall, 
Microsoft released this version of Windows about the same time IBM had 
got V2.0 out of the door, rendering Windows 3.0 compatibility obsolete. 
The new OS/2 can also run Windows Enhanced Mode applications, unlike 
its predecessor which only offered Standard Mode compatibility. 

The long awaited 32-bit graphics engine has finally been added. So has 
support for SVGA screen modes up to 1024 x 768 in 256 colours. 32-Bit 
drivers for several chipsets including Tseng, ATI and Trident are provided. 
Both Windows and OS/2 applications can run at full resolution on the same 
screen using a technology called ‘Seamless Windows.’ 

IBM says it has improved the overall performance. In particular, users 
should notice an improvement in the speed of the WorkSpace Shell (ie faster 
opening/closing of folders and painting of icons). Minimum system configu- 
ration has also relaxed. When V2.0 was first introduced, IBM recommended 
a 386SX-class machine with 6-8 MB memory as the base minimum. But 
nobody could achieve anything near acceptable levels of performance. In 
V2.1, a machine with 6-8 MB of installed memory is expected to offer a 
‘workable’ system. 

Here’s a few of the more interesting highlights in this release: built-in 
multimedia which can playback digital video at 30 frames per second 
without additional hardware support; Adobe Type Manager Level 2.5 and 
TrueType fonts. 

TBM is offering V2.1 at a special promotion price of £99 (diskette) or £90 
(CD-ROM) until the end of September. Upgrades from V2.0 start at £60. 
Details are available from the IBM Personal Systems Enquiry Centre on 0256 
841818. 
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The world’s easiest, 
fastest, most productive and 
most widely used language. 
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Borland Pascal 7.0 


Borland’s Pascal products set the 
standard for the Pascal language. And 
with good reason. They're faster, easier 
to learn and take you further in 
professional programming. With the 
power of Pascal at your command there 
are no limits, 


Borland” offers the Pascal to suit you: 


bos Windows 


Professional | Borland Pascal with Objects 7.0 


Turbo Pascal | Turbo Pascal 


Entry Level | 7.0 for DOS _ for Windows 1.5 


Borland Pascal with 
Objects™ 7.0 


The highest productivity professional 
programming system ever! Borland 
Pascal with Objects” 7.0 has everything 
the professional developer needs for 
DOS, DPMI and Windows 
development in a single box. And the 
built-in Application Frameworks™ 
give you great-looking user 
interfaces in just a few lines of 

code. You'll be amazed with the 
compiler’s speed. There is no better 
professional development system. 


Recommended Retail Price. £299.95 + VAT. 


Turbo Pascal for Windows 1.5 


Turbo Pascal for Windows 1.5 makes it 
easy to program in Windows. An on- 
line help system with over 100 sample 
programs helps with application 
development. And the enhanced 


Windows IDE includes colour syntax 
highlighting, SpeedBar”, and Turbo 
Debugger® for fast and easy debugging. 


Turbo Pascal for Windows gives you 
full support for features including 
Multimedia and Object Linking and 
Embedding (OLE). You can visually 
create objects with the Resource 
Workshop" 


No matter what your development 
experience, Turbo Pascal for Windows 
is the easiest way to learn Windows 
programming, 


Recommended Retail Price. £119.95 + VAT. 


Turbo Pascal® 7.0 for DOS 


Turbo Pascal 7.0 is the ideal way to 
take advantage of the ease of object- 
oriented programming to create DOS 
real mode programs. 


The many powerful features include 
a fast compiler and high-capacity 

DOS IDE with colour syntax 
highlighting to make your code easy to 
read and correct, and unlimited 
undo/redo. Object Browser™ lets you 
navigate through your source code with 
ease, and the on-line hypertext help * 
system provides over 1Mb of help text 
and copy-and-paste examples. 


Turbo Pascal 7.0 really is the easiest 
way to learn object-oriented 
programming for DOS. 
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Leader in Object Computing 


Borland is the leading supplier of 
Pascal solutions with more than two 
million sold. Borland’s compilers and 
tools are carefully crafted to meet all 
your needs - building on generations of 
Pascal products. Borland will deliver 
products that meet your future 
requirements by continuing to supply 
award winning Pascal solutions for 
DOS, DPMI and Windows. 


See your dealer today 


For further information and 
details of your local dealer call 


0800 212727 


or complete the coupon. 


ce Ae 
Please send me the FREE Pascal information 
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Il for V 

Three new add-ons for Smalltalk/V 
were announced at the Digitalk De- 
veloper’s Conference in May. From 
Polmorpic Systems there’s Tensegrity 
(£300), a network-independent ob- 
ject-oriented database. Objectshare 
Systems revealed the latest version of 
its WindowsBuilder Pro/V screen de- 
signer (Windows version £275). And 
from Tau Ceti there's WindowsBoos- 
ter (£49 for Windows, £99 for OS/2), 
a tool for improving the speed at 
which dialog boxes open and close. 
The UK distributor is Cocking & 
Drury on 071 4369481. 


Super Harlequin 

Super Harlequin is a new graphics 
controller, based on a 40 MHz 
TMS34020 processor, from Data- 
path. The card comes with 4 MB of 
installed memory and offers screen 
resolutions up to 1600 x 1200 with 
65536 colours, 16.7 million colours 
at 1152 x 900 and 1136 x 1152 
using 72 Hz refresh rates are also 
supported. The manufacturer claims 
Super Harlequin obtains Wintach 
benchmarks of up to 136. The 
£1,695 price tag includes several 
utilities and TIGA drivers for Win- 
dows and MicroStation. DataPath is 
on 0332 294441. 


Object Expo 

Just a little reminder: make a note in 
your diary to keep July 12-16 free. 
This is when Object Expo Europe will 
be taking place - at the Queen Eliza- 
beth II Conference Centre, London. 
According to Sigs Conferences, its 
organiser, Object Expo Europe is 
‘Europe's largest OOP conference 
and exhibition’. As a co-sponsor, 
.EXE warmly welcomes our readers. 
Over the five day event there will be 
a total of 45 lectures and keynote 
speeches from Apple’s Larry Tesler 
and IBM's Cliff Reeves. 


Nightmare! 

Today we have the Windows desktop 
- running on some 20 million ma- 
chines. What if the desktop grew to 
take over the entire office! Phones 
with ‘easier’ touchscreen interfaces 
(instead of the not-so-obvious but- 
tons of today), not to mention inter- 
connected, GUI-driven photocopiers, 
printers etc, Forget ‘what ifs’, this is 
an all new Gates-vision christened 
Microsoft At Work, with lung-bust- 
ing acronyms like WYPIWYFIWYCI- 
WYS (What You Print Is What You 
Fax Is What You Copy Is What You 
See). 


Manager for VBW 


ExpoTech has introduced what it 
claims to be one of the first project 
management tools for VBW. VB-Pro- 
ject Archiver automatically archives all 
code and form files used in a VBW 
project. It also offers version control 
and the ability to generate distribution 
files - achieved by creating an archive 
containing only the executable and 
DLLs/VBXs used by the application. 
Design-time custom controls are re- 
placed by their run-time equivalents. 
For the special introduction price of 
&69.95, ExpoTech is shipping a copy 
of VB-Tidy with VB-Project Archiver. 
This is a utility which saves the layout 
of the VBW IDE (including code win- 
dow) between VBW sessions. Expo- 
Tech is on 0273 746346. 


Soft Dial 


The Voice Toolkit from Telesoft is a 
library which enables developers to 
write voice processing software for the 
PC. Application areas include tone-dial 
driven menu systems and automated 
switchboards, such as those available 
on the Borland and Microsoft technical 
support desks, digital answer phones 
and tele-banking. It will soon be pos- 
sible to detect the telephone number 
of an incoming call. Telesoft suggests 
this will enable a sales person to access 
data such as order details for the callee 
even before the phone has been an- 
swered. 

The Toolkit contains over 300 func- 
tions and works in conjunction with 
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voice processing boards from Rhetorex 
and Aculab. In addition there is a 
dialogue library containing more than 
300 phrases. The manufacturer says 
that these may be stringed together by 
the play engine, without incurring un- 
natural pauses in between phrases, to 
produce contiguous speech. 

Voice Toolbox comes with a number 
of utilities for analysing and amplifying 
speech. Speech recordings can be 
stored in a library and loaded at run- 
time. Digital trunk standards like Euro- 
ISDN, DASS-2 and DPNSS are also 
supported. The Voice Toolkit costs 
£1000. Phone TeleSoft on 0272 706050 
for details. 


Help Magician 


This year we have seen a crop of 
development tools for creating Win- 
dows Help files. Windows Help Magi- 
cian from Software Interphase is one 
such product. The latest release offers 
a way to reference all occurrences of 
a specified hypertext link keyword 
automatically. This saves the devel- 
oper from having to go through the 
entire Help text, marking wherever the 
given keyword appears. Other features 
include secondary windows, non-scroll- 
ing regions and the ability to assign 
help context IDs for context-sensitive 
Help. In addition, the IDE enables 
developers to test help files without 
compiling. There is also a built-in edi- 
tor which can read and write .RTF files. 
Software Interphase (0101 401 
3972340) is selling Help Magician for 
$199 (single-user licence). 


AutoCAD++ 


DataSim has developed a C++ class library for writing AutoCAD applica- 
tions. CADObject offers 60 geometric classes which extend the facilities 
provided by AutoCAD. These include classes for primitives (points and 
lines); shapes (triangles, rectangles, quadrilaterals); sector and regular 
polygons and polylines. Utility classes are provided for manipulating 
homogeneous and heterogeneous lists. There are also template classes for 
matrices and 2D/3D transformations; a string class and a measurement class 
(eg for converting between degrees/radians). Further classes provide an 
object-oriented ‘shell’ to AutoCAD. This enables developers to perform such 
tasks as inserting objects into AutoCAD, creating Bill-Of-Materials (BOM), 
importing ASCII data into AutoCAD and setting up links between ADS and 
object-oriented databases. 

A number of examples of applying OOP to CAD are provided. These 
include classes for B-splines and beta splines; polymarkers and line style 
classes; graphs and histograms; motion simulation and classes of symbol 
libraries. DataSim aims to re-educate AutoLisp and C programmers. The first 
step it has taken in this direction is is to ship a course book on C++ along 
with the library’s standard reference and user manuals. CADObject is 
available for Borland V3.x and Zortech V3.x C++ compilers at the special 
promotion price of Dfl 1,875 (Dutch Guilders), until the end of August. 
DataSim is on 01031 20 6240055. 


6 .EXE Magazine, Vol 8, Issue 2, July 1993 


STAD3 


SoftTools for the Job 


AK NEW aK 
The Dolphin C Toolkit 


Microsoft and Borland programmers will find 235 useful functions all developed in response 
to the practical needs of professional software development by Dolphin Software of Austin, 
Texas. 


Included are 38 Date functions. Every date in an 11 million year period is associated with 
a unique long int. Hundreds of date formats are supported. Time functions, disk functions, 
string, directory, file and printer functions, together with unusual functions including 
command line processing, soft reboot, ROMBIOS date and ascertaining I/O direction make 
this a most comprehensive and versatile timesaver for the professional. Requires DOS 2.1 
or later. Included are 18 demonstration programs (source plus executable files) and a 232 
page manual. 

Price: £99 (source code available for £50) 


Dolphin Far Memory Manager 


Allows easy, effective and error free use of far memory (outside the default 640K default data 
segment) from within the small model. Includes reliable far memory allocation, dynamic 
allocation of multi-dimensional arrays in far memory, array bounds checking, representation 
of 2-D and 3-D arrays, extensive error checking, diagnostic information in a memory 
allocation log, diagnostic report upon detection of any of 27 errors and report of far heap 
structure. Requires Borland or Microsoft C/C++ (100% compatible with CodeView) and is 


supplied in small, medium and large memory models. 


Price: £99 (source available for £50) 


SHIELD Development 
Products 


TbxSHIELD 

Windows £255 OS/2 £255 

A toolbox library that allows sophisticated 
tool box controls to be created quickly and 
easily. 


InstallISHIELD 

Windows £255 OS/2 £510 

A graphical installation program builder 
for creating bullet-proof install routines. 


LogSHIELD 

Windows £335 OS/2 £510 

A graphical session recording and 
playback facility. 


MemSHIELD 

Windows £335 OS/2 £510 

High performance memory management 
library. 


DbxSHIELD 

Windows £335 OS/2 £510 

System for implementing the logic behind 
dialog boxes in an application. 


ResourceSHIELD 

Windows £150 OS/2 £350 

A fully integrated editing system for 
resource files. 


Object/Designer 


Create Windows applications 
as if your job depends on it! 
Out performing Visual C++, 
WindowsMaker and Case W, Object/ 
Designer enables developers to quickly 
generate all application source files 
needed for a Windows application. 
Includes support for ean 2,0, Microsoft 
C++/MFC, Borland C++/Object Windows, 
Turbo Pascal for Windows and 
CommonView with instant access to third 
party editors. 


The features of Object/Designer from 
Image/Soft make it the only code 
generation tool flexible enough to be used 
towrite full function Windows applications 
Price: £360 


KnowledgeMan 


NEW - Release 3.1 from mdbs 
The latest release of the KnowledgeMan fully 
integrated professional rdbms moves even 
closer to an event driven GUI environment. 
Enhancements include Compiler and User- 
Defined Functions, increased performance, 
improved system command interface, 
Optimized Query by Example, new Report 
Definition Language and Binary Large Objects. 


KnowledgeMan capabilities have always 
jone beyond those ofthe competition. Version 
.1 features and enhancements make it 

even easier to develop applications rapidly 

and without compromise. 


KnowledgeMa DOS SU - £990, OS/2 SU - 
KnowledgeMan DOS LAN - £1990, OS/2 
LAN - £2320 

Call for update and SUN or VAX prices. 


MagnaCharter Il 


Build flowcharts in minutes! 
MagnaCharter Il for Windows lets you build 
any kind of chart in minutes and includes all 
standard flowcharting symbols which are 
displayed as icons or add your own. Use the 
crowsfeet for database schemas. Features 
are accessed by drop-down menus, dialog 
boxes and multiple windows with a wide choice 
of text styles and sizes. Editing is simple 'cut- 
and-paste'. MagnaCharter Il appears as a 
99x99 spreadsheet. A wide range of printers 
is supported as is PostScript. 

Price: £160 


Other Products Supported by Systemstar 
SoftTools: 


zAppv 2.0 Win,DOS Text or Graphics £320 
ZA v 2.0 Windows NT £320 
v 2.0 OS/2 £420 

DOS £390, 386 e7e0 


0 
ProtoView Binary £149, Source £100 
ProtoGen £49 
DataTable Binary £75, Source £100 
PharLap 386|DOS-Extender £360 
Please check prices at time of order. 
Prices do not include VAT or carriage. 
All Trademarks Acknowledged. 


aK N. E Ww aK 
Phar Lap 
286IDOS Extender™ 
now with support for 
Microsoft Visual C++ 
and includes 286IVIMIM at 


no extra charge 

With the 286IDOS Extender and your 
Microsoft C, Borland C++ or MS Fortran 
and now Microsoft Visual C++ compiler, 
you have allthe tools necessary to quickly 

uild protected mode applications - often 
ay relinking without making source code 
changes. Protected mode applications 
cimemotyonanyDOS8Os86, 886 386Sx 
ofmemory onany , 386, 
or i486 PC, 286/DOS Extender is also 
compatible with Borland's Turbo Debugger 
and Microsoft's linker and CodeView 
debugger. Includes 2861VMM to access 
Virtual Memory too! 
Price: £360 


SoftTools from TeraTech 


Tools for C/C++ 


Ace Comparator £85 

Intelligently compares program files 
showing only the important differences. 
Ace can be configured to ignore 
differences in white space, indentation 
and even comment text!. Ace can also 
compare binary files such as EXEs and 

Js. 


NOW! £35 
E-MEM £89 
Virt-Win £225 


Tools for Visual Basic 
Dazzle/VB £225 


Dazzle adds professional sparkle to Visual 
Basic programs with complete image 
control. Display realistic images in 
Windows with Dazzle/VB image library 
then fade and wipe your pictures using 
one of Dazzle's many special effects. 


ProMath/VB £99 

Adds over 150 high level maths, 
engineering, physics and stat routines to 
Visual Basic. Included are trigonometric, 
hyperbolic, Airy, factorial, gamma, error, 
beta, Fresnel and Bessel functions. Also 
included are statistics, matrices, functions, 
FFTs, differential equations, curve fitting 
and more. 


VB/Lite £85 

Control printers, access communications 
and adds fast B-tree indexing and array 
manipulation to Visual Basic. 


TeleComm ToolKit £69 
Routines forX MODEM, MODEM7, Batch 
YMODEM and YMODEM batch file 
transfer; VT52, VT100 and ANSI-BBS 
terminal emulation. Baud rates up to 
19200. Command processor, script 
language, dialling directory, autodialling, 
pop-up windows and status bars. Full 
commented BASIC source code requires 
QuickBASIC PDS7 or Visual Basic for 
DOS and 1Mb of space. 


Dazzle/VB Professional £365 
FinLib/VB £119 
SpellCheck/VB £49 


For more information, 
demonstration disks or 
details of our 30 day trial 
offer call: (0992) 500919 


YSTEMSTAR 


SoftTools Limited 


1-3 Parliament Square Hertford SG14 1EX 
Telephone: (0992) 500919 Facsimile: (0992) 554261 
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DSP Sound 

Antex Electronics has introduced a 
sound card for the PC which it says 
offers ‘16-bit, broadcast quality ste- 
reo’. The Z1 incorporates the 
TMS320C25 DSP and supports sev- 
eral compression formats including 
DVI, CDI 8/16-bit PCM at real time 
sample rates to 44,1 KHz stereo. It is 
compatible with Windows 3.1, 
SoundBlaster and AdLib. There's a 
built-in SCSI controller for connect- 
ing CD-ROM machines and a ‘pro- 
slot’ for connecting external synthe- 
sisers, Z1 costs $595 from Antext 
(0101 310 5323092). 


BarMan 

No, this isn't a reference to the 
(empty) crates of Newcastle Brown 
at Software Development. BarMan is 
a VBW/Visual C++ custom control 
Sor producing barcode images. A de- 
veloper can set the code, code type 
size, font and background/fore- 
ground colours. Text can addition- 
ally be displayed with the barcode. 
Several coding schemes are sup- 
ported including EAN, UPC, ITF, 
Code-39 and Telepen, BarMan Pro- 
Sessional VBX costs £89 from dLSoft 
(081 5590049). 


Core Reporting 

WinQL, a Windows-based report 
generator from Core Software, is now 
available in the UK. The product al- 
lows users to build report queries, sort 
orders and screen layouts interac- 
tively. Database formats supported 
include Btrieve, xBASE, ObjectVi- 
sion, Paradox and DataFlex. Prices 
start at&295. WinQL is distributed in 
the UK by Data Access (071 
7294460) 


Techno... 

The West London Training and En- 
tenprise Council (TEC) reports that a 
lack of adequate IT skills is hindering 
Britain’s economic recovery. Its re- 
cent survey of employers showed 
shortages in system integration, ap- 
plication development, technical 
support, database design, C, UNIX 
and telecomms. So the recession is 
our fault, is it? Call 081 5771010 to 
purchase the full report (£235). 


*Tis not in the bond 

Shylock trades-in his abacus for a 
Dell Notebook in the RSC’s produc- 
tion of The Merchant of Venice set in 
the 90s which opened on 3rd June at 
Stratford: 

Set Currency Symbol=lb Flesh. 


A Class for ISAM 


ISAM Manager is a B+Tree/ISAM 
C++ class library which supports file 
sizes up to two billion records. There 
is an index-caching mechanism for 
reducing disk access and support for 
10 indexes per data file. A utility called 
DDF is used to convert the structure of 
a data file into a corresponding class 
definition. ISAM Manager also comes 
within the FScreen screen library and 
a program which generates a frame- 
work C++ file from the data file defi- 
nition. Nildram Software (0442 
891331) is offering ISAM Manager for 
&29 until the end of December. 


Farming 
The term ‘Farm’ has been used re- 


cently by DEC to describe a way to 
achieve near-supercomputer perform- 


News 


ance using a cluster of DEC Alpha 
workstations. The Networked Applica- 
tion Toolkit does more-or-less the 
same thing on a PC network. Accord- 
ing to the manufacturer Novalis: ‘the 
toolkit lets you make use of thousands 
of mips that are idled away by office 
computers every day.’ It works by 
allowing programmers to access net- 
work-wide shared memory and so 
write distributed applications. 

The multi-node model of distributed 
processing is also available. Here there 
may be a setup comprising severa 
workstation ‘nodes’ each capable o! 
running a particular application (or 
service), say a database query. When 
a message is sent to fire-up this service, 
one of the nodes will start processing. 

The Networked Application Toolki 
is available as a .VBX custom control 
for Visual Basic and as a C library at 
&79 each. Novalis is on 0707 328715. 


Ta] 


Chart Lib for VC++ 


Graphics Server V2.20 is the next incarnation of Bits Per Second’s (BPS) 
graphing and charting library. Highlights include a class library for Visual 
C++ (as discussed by John Marsh of BPS in the June ’93 issue of .£XE) and 
an FLL for FoxPro. BPS says that its class library is one of the first third-party 
classes for Visual C++, Other features include: the ability to run code written 
in dGE (the company’s xBASE graphing library) under Windows unmodi- 
fied; several new graph types and a ‘Hot Graphs’ facility. This enables an 
application to respond to the user clicking areas of a graph or chart. In the 
illustration depicting energy consumption against population size, if the user 
clicks on the bar for UK energy consumption, a pie chart pops up showing 
energy sources for the UK. 

This release includes the source code for the AutoGraph API, a family of 
high-level routines for generating graphs and charts. BPS says itis possible 
to open a graph window, set up titles/legends/labels and plot the data using 
just eight function calls. The low-level API offers 150 drawing and statistical 
functions, Graphics Server costs £245 and includes ChartBuilder (a cut-down 
version for the VBW toolbox). ChartBuilder is available separately at a cost 
of &85. Bits Per Second is on 0273 727119. 


S| Graphics Server 2,20 


Trend 
Data 
Projection 


Population 


Energy 
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., So | stayed up all 
night fixing it, and in the 
morning Paul saved his 
version and overwrote all 
my work." 


“How did this bug 
get back in here - we 
fixed it last week.” 


“The auditors called - they 
want to know who can 
change our code 
and how we track 
changes." 


“The demo crashed in 


front of the client, Fred «ye NEED Pvcs” 
thinks the printer drivers 


are the wrong version." 


Protect Your Code, Your Projects, and Your Reputation 


Our customers know PVCS saves them money, 
time, and anguish. The painful scenarios PVCS 
avoids are familiar to all developers. Because all 
developers do configuration management. If you 
manage more than a few modules of code, have 
more than one person working on a project, or do 
LAN-based development, then you already do it. The 
only question is how well. And the answer affects the 
reliability of your projects, the productivity of your 
developers, and your reputation with your users. 


The PVCS Series offers a complete solution to 
configuration management, that’s important because 
development is getting more complex - not less. 
Implementing a partial solution today is simply 
creating tomorrow’s problem. 


PVCS Version Manager oversees changes to the 
elements that comprise a software system, tracking 
who made changes, when and why they made them, 
and permitting any previous revision of a module or 
any prior version of the entire software system to be 
reconstructed at any time. PVCS Version Manager 
also includes facilities to control parallel develop- 
ment and to reconcile any conflicting changes made 
to a module, PVCS enables a productive workgroup 
approach to development, because it is specifically 
architected for the LAN, and because the feature set 
and GUI interfaces specifically support distributed 
client server development. Modules are retrieved for 
work from wherever they are stored - developers 
don’t have to remember where the archives are 
located. This simplifies and encourages code reuse, 
even across operating system boundaries. 


PVCS Configuration Builder automates execu- 
tion of software development tools, permitting 


Readmar Systems 


L l 


239 Kilburn Park Road London NW6 5LG 


systems to be built with absolute repeatability. 
This increases productivity, but more importantly, 
entirely eliminates a common source of errors. 
PVCS Configuration Builder can now embed 
“footprints” of vital historic information into 
compiled objects and can act conditionally on 
footprint information. 


PVCS Production Gateway synchronizes the 
mainframe library to the LAN version archives, 
providing the control and auditability of the main- 
frame without bottlenecking the productivity of the 
LAN environment. 


PVCS Developer’s Toolkit delivers full PVCS 
functionality to your development environment 

or to your applications in the form of DLLs, import 
libraries and header files. The scope and quality of 
the PVCS DTK meets IBM and other programming 
standards for API implementation. 


PVCS Reporter lets you quickly produce reports 
using an advanced graphical interface (in MS-DOS 
or Presentation Manager) to access the wealth of 
project information managed by PVCS. You can use 
predefined queries or build your own. PVCS 
Reporter queries can span multiple projects in 
distributed architectures to select, merge, sort, 
display and print exactly what you need. 


PVCS is the undisputed leader in Configuration 
Management for LANs. It operates seamlessly 
across MS-DOS, OS/2, VMS, and a host of 


Unix environments. 


The PVCS Series is so 
accommodating that it 
snaps right into existing 
projects. You don't 
have to wait until you 
start a new project to 
implement it. More than 
a few of our customers 
have purchased PVCS to 
salvage projects that 
were dissolving into 
chaos... and they've been 
successful. Cure your 
biggest headaches 
before they happen. 


Call now for a FREE copy 
of “Cost Justifying 
Software Configuration 
Management”. 


Phone or fax for details of the PVCS Services. Tel 071 625 5255 Fax 071 624 9404 


Evaluation Copies Available 
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Letters 


Letters 


We welcome letters on subjects of interest to our readers. Please write to The Editor, EXE Magazine, 10 Barley Mow Pas- 
sage, Chiswick, London W4 4PH. Unless your letter is marked ‘Not for Publication’, it will be considered for inclusion 


Flattening May #1 


Sir, 

I was brought up to believe that 
65536 + 1 = 0, that neither the Earth 
nor memory is flat, and that all pro- 
grams, no matter how trivial, should 
make frequent use of multiple stacks, 
multiple heaps and overlays. Jules May 
is to be applauded for seizing the 
initiative and setting a most excellent 
example in championing the cause of 
segmented architectures (Mayhem, 
.EXE June '92). 

I have always admired the cleanli- 
ness of Intel’s 80x86 architecture, but 
I still feel that there are not enough 
memory models to satisfy DOS devel- 
opers: RARE, WELL_DONE, BIJOU 
and HUMUNGOUS would be obvious 
additions to the stable. A true 8-bit 
model is conspicuous by its absence - 
every skilled software engineer knows 
that well-designed data structures can 
be implemented in under 256 bytes - 
and so I would propose that a MICRO- 
SCOPIC memory model is added be- 
low TINY. 

My recent move to 32- and 64-bit 
systems has proved to be something of 
a culture shock. The near, far, 
huge, NEAR, __far and _some- 
where_in_memory tokens are not 
available and so I am strait-jacketed 
into using portable C/C++ features. 
Without the challenge of codrdinating 
a cocktail of third party software, to 
compensate for the machine and its 
operating system, I have been left with 
more time to develop software. 

The implications on job security, of 
not kludging the code to fit the archi- 
tecture, are both worrying and intoler- 
able. The flat earth bandwagon must 
be stopped. 

Kelvin Henney 
Bristol 


Flattening May #2 
Sir, 

I read Jules May’s comments on Win- 
dows NT with considerable interest, 
not least because they virtually coin- 
cide with my own. It is undoubtedly 
true that the marketing-led imposition 
of these complex and resource-hungry 
systems, the steep learning curve that 
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on this page. 


they imply and lack of platform stabil- 
ity that they represent is a considerable 
problem to developers. However, I 
must take issue with him over the 
desirability of a ‘flat’ memory architec- 
ture. 

It is true that segmentation of itself 
is not a negative feature in a computer 
system, being useful for techniques 
such as Jules May describes: multiple 
small allocations, debugging firewalls 
etc. But as soon as the segment size is 
perceived as inadequate to fit some 
data construction for which there is 
otherwise ample memory, the situ- 
ation is very, very different. Whether 
the programmer codes a solution di- 
rectly or uses a facility supplied with 
the development toolset, the result is 
an artificial structure imposed on the 
data which reflects the underlying seg- 
mentation; such systems are difficult to 
comprehend, debug and maintain, in- 
efficient in their use of processor time 
and may present porting difficulties. 

I believe that a ‘flat? memory address- 
ing model is a genuine step forward 
and, once supported by the processor 
hardware, is a vital feature to embrace 
in any operating system, NT or other- 
wise. Despite the hype, cost and com- 
plexity, NT does at least offer the PC 
platform a memory contiguity which 
68000-based machines have permitted 
from Day 1. PR Collins 

Software Development Manager 
Stag Programmers Ltd 
Herts 


Not fooled. 
Sir, 

Mike Mitchell (Soapbox, June 1993) 
states that he has a foolproof method 
of installing software packages. It is a 
brave man who claims in print that any 
software system is foolproof, far less 
one that clearly isn’t. 

Mike recounts problems with instal- 
lations not detecting insufficient disk 
space and copying to directories with- 
out checking that they exist. These are 
problems of program logic which can- 
not be solved by a different method of 
starting the program. The only solution 
is more careful design and analysis. 

Furthermore, how does he propose 
to load programs onto my hard disk 


when booting with his CONFIG.SYS? 
How will he know what compression 
software I may be using? How does he 
know whether I need to load a driver 
for my SCSI disc? 

Without a doubt, we need to see 
much better installation procedures - 
but self-booting disks is not one of 
them. Tan Cargill 

Surrey 


Prooofing Prublems 
Sir, 

I very much enjoyed June ’93 .EXE, 
especially the STOB article. It was with 
much interest that I read Dan O’Brien’s 
article on zApp Application Frame- 
works, which was very good and made 
zApp sound quite appealing. How- 
ever, when I reached the figures show- 
ing zApp screen I got a little bit 
confused: 

A) The Figure headings - Figure 3c, 
Figure 3b, Figure 3c and Figure 3d. 
Two Figure 3cs - how nice! 

B) Figures 3c1, Figure 3b and Figure 
3c2 all show the country as United 
States, the currency symbol as ‘$’. The 
sample boxes for all of these also show 
‘$ as currency, all well so far. In Figure 
3d, however, the country was still set 
as the United States, the currency was 
set at a ‘$’ but the samples had a ‘& 
next to them, oops! 

This unfortunately let down an oth- 
erwise very good article. 

Mr P Williams 
Analyst Programmer 
Ericsson Data UK Lid 


We apologise for the cock-ups Mr Wil- 
liams mentions, and for three others 
that a superficial glance through the 
article revealed to me (but only after it 
was printed, natch). We are, after all, 
the magazine whose proofing even the 
legendary Gruaniad mocks! Anybody 


. interested in a spot of charity proof- 


reading? - Ed. 


_ Letter of the Month 
The writer of the letter of the month, as 
judged by the Editor, will receive a £20 
book voucher, courtesy of Just Com- 
puter Books. The best letter is the one 
printed first. Please note that letters 
submitted to this page may be edited. 


ROGUE WAVE 


Rogue Wave Software are committed to 
allowing users to tap all the power that 
C++ offers and have a range of 
powerful, efficient, and portable C++ 
class libraries... 


Tools.h++ 


- the "essential" C++ class library 

Rogue Wave's best selling industry 
standard C++ library, Tools.h++, is a 
complete toolbox of nearly 100 C++ 


classes. It is a set of efficient and 
versatile C++ foundation classes that 
will make virtually any programming 
job easier. 


Tools,h++ is an "industrial strength" 
library that has been used in many 
commercial applications, small and 
large, and can easily be integrated with 
other class libraries. All classes have a 
Persistent Store facility. 


Tools.h++ comes complete with source 
code and is an excellent example of 
how to write ‘true C++ code correctly, 
All non-Windows ‘classes are strictly 
portable between DOS and UNIX. 


RENT 


‘Communication and Telemetry Consultants iF 


BEWARE THE [2 


C++ Class Libraries 


.. NEW... 
Chart.h++ 


- portable 2-d/3-d business graphics 
Chart.h++ is a complete package which 
allows the C++ programmer to create 
and manipulate 2-d and 3-d business 
graphics using existing or user defined 
charts - quickly and easily. 


DB.h++ 


- the portable, database interface 

An elegant C++ interface to the API's of 
the top RDBMS, DB.ht++, allows 
programmers to develop database 
applications which will be portable 
across databases, operating systems, and 
compilers. 


Math.h++ 


- just one of our numerical libraries 

a complete set of extremely fast C++ 
classes to handle all of your statistic, 
linear regression, FFT’s, random 
numbers, vector and matrix needs. 
Runs on both DOS and UNIX. 


View.h++ 


- the C++ library for Motif developers 
View.h++ is a powerful and efficient 
C++ library that encapsulates 100% of 
the functionality of the industry 
standard OSF/Motif. Runs on UNIX. 


For sales and support of 
ROGUE WAVE SOFTWARE 
and other C++ class libraries call 


Hypersoft Europe 


Northern Office: 0602 - 376550 
Grove House, 13 Main Street, 
Keyworth, Notts., NG12 5AA 
Southern Office: 0273 - 834596 
PO BOX 901, Hassocks, 

West Sussex, BN6 9ZS 


This caterpillar is frustrated: he has trouble with his 


Marketing. 


He needs the people 
with buying power to 

\ know he exists and that 
_ \ he writes great software, 


PIRATE'S 
PATCH! 


You sell you software. 
You don’t give it away. 
It needs the kind of 
copy protection that 
only a top quality 
UNPATCHABLE 
dongle affords, but 
you don’t want to = 
pay the Earth for it, and you want to be sure that you'll not be 
making mistakes in incorporating it into your code. The 
MAXPRO system is for you. There are microprocessor based 
units at realistic prices which take care of complete .EXE files 
without access to source code. Set stop dates, tamper detection 
and many other facilities on a menu-driven attachment program. 
MAXPRO even copes with such as Clipper, Quick Basic and 
Clarion files with internal overlays. NEAT TRICK! There 

are refreshingly low cost dongles available for Windows too! 


NEW! - NETWORKING CAPABILITY F.O.C. 


Worse still he doesn't 
read .EXE and so he 
hasn't read this. 


Don't be a frustrated 


9 caterpillar. 


Call the Software 

Developers Directory 

today for details of how 

your name and skills can get in front of the right 

people, the people who buy - and all for less than the cost 
of a good linker. 


Fax your business card to (0582) 483846 
or 
Call us on (0582) 487111 


Brent Communications 
Unit 2 

Dragon Industrial Estate 
Harrogate (UK) HG1 SDN 

Tel (0) 423 566972 


Fax (0) 423 501442 for more details, a priority Registration Form and 


our very own FREE leaf! 
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Aw: 


And the winner is... 


Who did you vote for? Willie Watts presents the results of the 


.EXE Software Development Awards 1993, and reveals his Editor's Choice. 


As the more observant of you will have 
noticed: this year, in conjunction with 
that noblest of brews Newcastle Brown 
Ale, we initiated the .EXE Software 
Development Awards, to be presented 
to the manufacturers of the best soft- 
ware development tools. 


The awards have been made in three 
categories. Best Compiler and Best Soft- 
ware Development Tool were selected 
by the votes of readers; the other, 
Editor’s Choice, was ‘in my gift’ as the 
saying goes. As a prize, a repre- 
sentative of each of the winning com- 
panies has received (if all went well) 
two crates of the aforementioned beer 
to dispose of as he sees fit. 


We received just under 200 nomina- 
tions (ok, 178) for the Reader catego- 
ries, so many thanks to all those who 
bothered to vote, and a long drawn out 
raspberry to the rest. The three win- 
ners of lifetime subs are Peter Wippell, 
M Russell and Dr R Whitaker. 


Best Compiler 


This category - like the other two - is 
dominated by C++, which now seems 
to have matured to the point where 
people are using it sufficiently to have 
opinions, instead of leaving it on the 
shelf and worrying about it. Of the 
other languages, not one cracked the 
2% mark (3 votes); not the various 
Basics (possibly because the question 
was worded badly; I perhaps should 
have said ‘Language Implementation’ 
rather than ‘Compiler’) nor the xBASEs 
nor even the Pascals. 


So the action was all in C and C++, and 
mostly ‘mainstream’ manufacturers. 
Symantec/Zortech, once king of all 
things C++, picked up five votes for its 
DOS/Windows effort. Microsoft’s new 
Visual C++ picked up 12%, but was 
beaten off by GNU C/C++, with 16% 
(this was the firm favourite of those 
few who voted by email on CIX). But 
the easy - and majority - winner was 
Borland C++ 3.1, which picked up a 
massive 54% of the votes. 
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Best Tool 


Rather predictably, this section was 
much more fragmented - about 60 
different tools got nominated. If a 
product had two votes, it was doing 
well. Quite a few named their favourite 
editors (whether it be Brief or Elvis), 
or their favourite UNIX tools. A couple 
of people named OS/2 2.0 in this 
category. GNU’s implementations of 
grep, yacc etc again showed well - if 
the GNU camp had organised itself to 
vote for a single tool, it would have 
stormed it. The Zinc C++ class libraries 
also managed to get its head above the 
parapet. 


But the winner, riding on the back of 
the Microsoft Visual C++ compiler 
vote, was the bundled tool/library 
package (ClassWizard, AppStudio 
and MFC 2.0). All but one who voted 
for Visual C++ also voted for these 
tools; but only a couple of those who 
voted for Borland C++ voted for its 
tools and class libraries. 


My Choice 


It’s said to be foolish to explain one’s 
actions in this situation; but there 
again, it’s fairly rotten to produce a 
result out of thin air without any justi- 
fication: so here’s a summary of the 
agonising which brought me to my 
selection. 


The Big Players get plenty of publicity, 
and were bound to do well in the 
voted awards, so to limit the range and 
even the score I decided to focus on 
the products of the smaller outfits. 


I was tempted by a product called 
Clip-4-Win, because it managed what 
I believed was impossible (allowing 
Clipper to be a Windows compiler) - 
but rejected it because it was intrinsi- 
cally something of a kludge, however 
ingenious. I thought about a couple of 
editors that I use (I’m not telling 
which), but decided I couldn’t justify 
choosing either in the face of the 
screams of rage from those who hap- 
pen to use some other one. I thought 
about the Multiscope debugger 
(whose user interface shows us where 
CodeView belongs - unwrapped, in 
the box), and a really neat custom 
control that I found, and... 


In the end, I plumped for Inmark’s 
zApp Application Framework, 
which I co-reviewed with Dan O’Brien 
last month. Of all the C++ encapsula- 
tions of Windows in all the bars in all 
the world, we both felt this was the 
best attempt we had seen, and was 
something of a landmark in the use of 
this important language. So congrats to 
Inmark and Microsoft and Borland, 
and comizes to everyone else. 


OBJECT-ORIENTED - MULTIPLATFORM - SINGLE-SOURCE - C++ 


ZINC™ APPLICATION FRAMEWORK™ 3.5 


: Multiplatform Flexibility 


: From One Application 


: Framework. 


yAatiauwa is an essential component in software design. Your 
4 oper : development tools should allow you to easily incorporate new 
features and technologies into your applications without rewriting 


all of your code. That's a tall order if your development tools are 


designed like a straight-jacket. Zinc Application Framework 3.5 
and Zinc Designer” give you flexible and extendible support for 
Microsoft Windows, Windows NT, OS/2 2.0, UNIX Motif, DOS 
Graphics and DOS Text. And Zinc does it with ONE set of source 


code. Zinc'’s multiplatform, object-oriented architecture won't 


confine your application development options today... or tomorrow. 


FOR A FREE ZINC DEMO KIT, CALL US TOLL FREE TODAY AT 


1.800.638.8665. IN EUROPE CALL +44 (0)81 855 9918 


DOS GRAPHICS 


ZINC SOFTWARE INCORPORATED, 405 SOUTH 100 EAST, 2ND FLOOR, PLEASANT GROVE, 
UTAH 84062, TEL 801.785.8900, FAX 801.785.8996, BBS 801.785.8997. 


EUROPE: ZINC SOFTWARE (UK) LIMITED 58-60 BERESFORD STREET, LONDON SE18 68G, 
TEL +44 (0) 81 855 9918, FAX +44 (0) 8] 316 7778, BBS +44 (0) 81 317 2310 


@ COPYRIGHT 1992 ZINC SOFTWARE INCORPORATED, ALL RIGHTS RESERVED. ZINC, ZINC 
DESIGNER AND ZINC APPLICATION FRAMEWORK ARE TRADEMARKS OF ZINC SOFTWARE 
INCORPORATED. OTHER TRADEMARKS ARE QWNED BY THEIR RESPECTIVE COMPANIES, 
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DOS TEXT 


Text into Fax does go 


In the first of a major new .EXE series, Andrew Margolis explains some basics of facsimile 
technology, and details how to convert text to a faxable format. 


It is now becoming standard for even 
inexpensive modems to include both 
send and receive Group 3 fax facilities 
as part of their standard capabilities. 
Unfortunately, while most people are 
relatively happy with the program- 
ming file transfers and normal data 
communications, the way that fax 
transmissions work and the details of 
how to write your own fax software 
remain rather more of a closed book. 
This is due both to lack of information 
and also to the fact that developing 
techniques for encoding, decoding, 
transmitting and receiving faxes pre- 
sents specific programming problems 
of their own. Modem manuals don’t 
help much in sorting out any of these 
problems. 


The result of this is that most people 
are restricted to using the fax software 


that comes free with their modem, 
which is something of a shame, as free 
software is often not going to do what 
you want in the way you want to do 
it. The purpose of this article, and 
subsequent ones in the series, is to 
present the basics of how fax software 
can be constructed. This month we 
aim to present enough information to 
enable you to turn an ordinary ASCII 
text file into a fax image file on disk 
ready for sending. 


The bible for anyone looking for the 
specifications for encoding Group 3 
fax messages is the standard laid out 
in CCITT Recommendation T.4. which 
is over 30 pages long. While the infor- 
mation contained in this article hits the 
high spots and is intended to be suffi- 
cient for anyone who is writing soft- 
ware for himself, it might make sense 
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Figure 1 - 
Guaranteed reproducible area of T.4 fax recommendation 
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for really serious commercial users to 
look up the original. The recommen- 
dation is designed for sending A4 
pages, though it includes options for 
larger and smaller page sizes which 
won't be dealt with here. 


Basic Fax Facts 


The horizontal resolution of a fax is 
specified as being 1728 picture ele- 
ments (known as ‘pels’ to the CCITT, 
and as ‘dots’ or ‘pixels’ to everyone 
else) on a 215mm line. This works out 
at 8.04 pels/mm. The vertical resolu- 
tion is normally 3.85 lines/mm. There 
is an allowable deviation of + 1%, 
which means that the resolution of 
transmitted or reproduced pictures 
could range from 7.96 x 3.81 to 8.12 x 
3.89. 


There is an optional fine resolution of 
7.7 lines/mm, which is double that of 
normal resolution. This needs pointing 
out as most fax machines and fax 
modems support it, but since it re- 
quires only trivial modifications to 
techniques for generating and decod- 
ing normal resolution faxes, it won’t be 
mentioned again. 


A number of things about the T.4 
specification are easy to miss. The 
most commonly overlooked pitfall is 
that though the specification is de- 
signed for sending A4 pages, it doesn’t 
itself conform to A4 dimensions. In 
particular, the T.4 horizontal resolution 
is based on a 215 mm line which is 
clearly a rounded figure designed to 
accommodate US and old Imperial 8.5 
inch wide paper sizes as well as official 
210 mm wide A4 paper. This means 
that while a fax line always consists of 
1728 pels, an A4 line when faxed 
consists of 1688 pels. Of course, if you 
ignore the difference and encode all 
A4 lines to the full 1728 pels, the 
resulting fax file will be perfectly legal 
and will still be sent, but the margin of 


TERMINATING CODES 
run white black 

code code 
0 00110101 0000110111 
1 000111 010 
2 0111 in 
iS 1000 10 
4 1011 011 
5 1100 0011 
6 1110 0010 
7 1114 00011 
8 10011 000101 
9 10100 000100 
10 00111 0000100 
an 01000 0000101 
12 001000 0000111 
13 000011 00000100 
14 110100 00000111 
15 110101 000011000 
16 101010 0000010111 
17 101011 0000011000 
18 0100111 0000001000 
19 0001100 00001100111 
20 0001000 00001101000 
21 0010111 00001101100 
22 0000011 00000110111 
23 0000100 00000101000 
24 0101000 00000010111 
25 0101011 00000011000 
26 0010011 000011001010 
27 0100100 000011001011 
28 0011000 000011001100 
29 00000010 000011001101 
30 00000011 000001101000 
31 00011010 000001101001 
32 00011011 000001101010 
33 00010010 000001101011 
34 00010011 000011010010 
35 00010100 000011010011 
36 00010101 000011010100 
37 00010110 000011010101 
38 00010111 000011010110 
39 00101000 000011010111 
40 00101001 000001101100 
4 00101010 000001101101 
42 00101011 000011011010 
43 00101100 000011011011 
44 00101101 000001010100 
45 00000100 000001010101 
46 00000101 000001010110 
47 00001010 000001010111 
48 00001011 000001100100 
49 01010010 000001100101 
50 01010011 000001010010 
51 01010100 000001010011 
52 01010101 000000100100 
53 00100100 000000110111 
54 00100101 000000111000 
55 01011000 000000100111 
56 01011001 000000101000 
57 01011010 000001011000 
58 01011011 000001011001 
59 01001010 000000101011 
60 01001011 000000101100 
61 00110010 000001011010 
62 00110011 000001100110 
63 00110100 000001100111 

Figure 2a - 


Terminating run length codes. 


error on the resulting images will be 
rather more than the permissible 1%. 
Further, keeping a 3.85 lines/mm ver- 
tical resolution while ignoring the dif- 
ference between fax and A4 
dimensions will result in reproduction 
errors such as circles on originals being 
stretched out to ellipses at the destina- 
tion, and horizontal scales on faxed 
maps becoming inaccurate for estimat- 
ing vertical distances. 


Another commonly overlooked fea- 
ture of the T4 specification is that it 
includes a number of allowances de- 
signed to ensure that faxes are prop- 
erly encoded and reproduced by 
mechanical scanners and printers. 
These include at least 4 mm unrepro- 
ducible space at the top of a fax to 
allow for paper insertion loss, and +6.8 
mm further loss at the bottom of a fax 
to allow for paper skew, gripping loss 
and scan line tolerance. Horizontally, 
a further error of + 13.4 mm on both 
the margins needs to be allowed for 
also. The CCITT therefore publishes a 
diagram of the guaranteed reproduc- 
ible area of an A4 page, a version of 
which is itself reproduced in Figure 1. 
You'll see that when everything is 
taken into account, only the middle 
196.6 mm of an A4 page is guaranteed 
to be faxable. This means that the 
number of pels allowed for one line 
froma source file comes down to 1580, 
with a compulsory white space margin 
of 74 pels on both the left and right 
hand sides of the paper. 


T.4 encoding rules 


The rules for encoding a fax are quite 
straightforward. We quote directly 
from the CCITT T.4 documentation, 
which is unambiguous and reasonably 
concise: 


‘A line of Data is composed of a series 
of variable length code words. Each 
code word represents a run length of 
either all white or all black. White runs 
and black runs alternate. A total of 
1728 picture elements represents one 
horizontal scan line of 215 mm length. 


‘In order to ensure that the receiver 
maintains colour synchronisation, all 
Data lines will begin with a white run 
length code word. If the actual scan 
line begins with a black run, a white 
run length of zero will be sent. Black 
or white run lengths, up to a maximum 
length of one scan line (1728 picture 
elements or pels) are defined by the 


Fax 


code words .... (reproduced here in 
Figure 2) .... The code words are of 
two types : Terminating code words 
and Make-up code words. Each run 
length is represented by either one 
Terminating code word or one Make- 
up code word followed by a Terminat- 
ing code word. 


‘Run lengths in the range of 0 to 63 pels 
are encoded with their appropriate 
Terminating code word. Note that 
there is a different list of code words 
for black and white run lengths. Run 
lengths in the range of 64 to 1728 pels 
are encoded first by the Make-up code 
word representing the run length 
which is equal to or shorter than that 
required. This is then followed by the 
Terminating code word representing 
the difference between the required 
run length and the run length repre- 
sented by the Make-up code. 


‘End-of-line (EOL): This code word 
follows each line of Data. It is a unique 


code word that can never be found 
within a valid line of Data: therefore, 
resynchronisation after an error burst 
is possible. In addition, this signal will 
occur prior to the first Data line of a 
MAKE-UP CODES 
run white black 
code code 
64 11011 0000001111 
128 10010 000011001000 
192 010111 000011001001 
256 = 0110111 000001011011 
320 00110110 000000110011 
384 00110111 000000110100 
448 01100100 000000110101 
512 01100101 0000001101100 
576 01101000 0000001101101 
640 01100111 0000001001010 
704 011001100 0000001001011 
768 011001101 0000001001100 
832 011010010 0000001001101 
896 011010011 0000001110010 
960 011010100 0000001110011 
1024 011010101 0000001110100 
1088 011010110 0000001110101 
1152 011010111 0000001110110 
1216 011011000 0000001110111 
1280 011011001 0000001010010 
1344 011011010 0000001010011 
1408 011011011 0000001010100 
1472 010011000 0000001010101 
1536 010011001 0000001011010 
1600 010011010 0000001011011 
1664 011000 0000001 100100 
1728 010011011 0000001100101 
EOL code word 000000000001 
Figure 2b - 


Make-up run length codes. 
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getfont: 
push es 
push si 
mov 
mov bh, 6 
int 10h 
push es 
push ds 
pop es 
pop ds 
mov si,bp 
mov di,offset fonts 
mov ex, 256*16/2 
rep movsw 
pop si 
pop es 


ax,1130h ; video function 11h subfunction 30h 
; with bh=6 
; returns font pointer in es:bx 


; font pointer now in ds:si 

; our array pointed at with 

7 es:di 

; length of font table in words 
; now copy it into our array 


Figure 3 - Downloading the VGA 8 x 16 font 


page .... the end of a document trans- 
mission is indicated by sending six 
consecutive EOLs.’ 


Digitising text 


We've now established both the physi- 
cal parameters of a fax image and the 
format it takes. It is quite a good idea 
to convert a text file into a fax file one 
line at a time. The advantage of this is 
that text files of any length can be 
converted without running any risk of 
running out of memory space, as we 
can work out exactly what the maxi- 
mum requirements of any line might 
be. Without attempting to give the 
code for a complete program, the rest 
of this article will concentrate on the 
trickier points involved in turning text 
into a fax. The code fragments are 
fairly standard C, and are intended 
simply for illustration. They ought to 
translate into other languages and dia- 
lects fairly easily as the only capabili- 
ties that are really required are the 
ability to do both arithmetic and simple 
boolean algebra (ANDs and ORs) on 
unsigned 8 and 16 bit values and the 
ability to construct and access indexed 
arrays. 


The first step we take is to reduce a 
single line of text to a series of dots. 
This digitisation process is actually 
quite straightforward’ once you have a 
font table of the correct size. Determin- 
ing the size of the font may on the 
surface appear to be mostly a matter 
of personal taste - a smaller font allows 
more lines on a page and more char- 
acters on a line, but runs the risk of 
illegibility due to transmission errors if 
sent over bad telephone lines, while 
an over-large font might not allow a 
normal page to be sent. 
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However, another factor that affects 
the choice of a font is how easy it is to 
structure the data in memory, It’s ob- 
vious that a font which is eight bits 
wide will fit neatly into a straightfor- 
ward array, while a font that is nine 
bits wide isn’t quite as easy or quick to 
access and manipulate. It might make 
apparent sense to choose a byte-wide 
font for just this reason, but unfortu- 
nately, if such a font is used on an A4 
fax line we’d get almost 25 characters 
to each inch. Obviously, when com- 
pared to a normal line of A4 text, each 
letter will be rather too small. This is 
actually quite a serious problem, as 
small letters are much more prone to 
become illegible through printing and 
transmission error, 


Using a Font Table 


A solution to this problem which keeps 
the convenience of programming for 
an 8-bit font, and also reproduces text 
to a scale approximating that of a 
printer, is simply to adapt an 8 x 16 
text font by scaling it up to 20 x 16. 
The base font vertical dimension of 16 
dots already translates directly to a 
little over six lines per inch (assuming 
the standard 3.85pels/mm and 281mm 
reproducible A4 length). For the hori- 
zontal dimension we can add a dot for 
an inter-character gap on each side, 


Fax 
giving us a width of 10 dots, and then 
double up the width to 20 dots per 
character. This allows 79 characters on 
our 1580 pel faxed A4 page. Using a 
20 x 16 font corresponds quite well to 
the format of a printed page on a 
standard printer of 80 characters per 
line and six lines per inch. 


The deciding factor in choosing an 8 x 
16 font for your first fax program is that 
anyone with an IBM PC and a VGA 
card can download the font into a 
simple two-dimensional array of 256 
characters by 16 rows with each row 
of eight dots directly represented by 
one byte. This will be suitable for 
almost immediate use. Assembler code 
for downloading such a font is shown 
in Figure 3 - it will embed in many PC 
dialects of C for inline assembly and 
subsequent run-time downloading. 


Once you have a font, the simplest 
method of digitising a line of text is to 
loop through the line once for each 
vertical row. The value of each char- 
acter in the line and the value of the 
row as taken from the variable control- 
ling the loop become direct indices to 
a 16-byte wide font array. The code for 
doing this (in Figure 4) is surprisingly 
compact, consisting of two nested for 
loops (though in practice, you might 
want to expand tabs rather than ignore 
all control characters). The moral to be 
drawn here is that if you get the data 
structure right, the hard work goes out 
of the programming. 


Each of the 16 rows of dots generated 
for each line of text has to end with a 
unique sentinel (ZOLFLAG), which 
can be any configuration of bits not 
occurring in the font data. A good 
choice if using a VGA font is 0x01. 
This is because we don’t know in 
advance how many characters there 
actually are in a line of text. When we 
come to encoding the fax, if we hit an 
EOLFLAG in the bit image, we simply 
pad out the rest of the line to 1728 pels. 


for (row=0 ; row<16 ; row++) 

{ 
for (i=0 
if (line_of_text [i]>31) 


bit_image[image_offset++] 


} 


fgets (line_of_text,80,input_file) 


; i<strlen(line_of_text) ; i++) 


fonts (line_of_text(i]] [row] ; 
bit_image[image_offset++]=EOLFLAG ; 


Figure 4 - Digitising a line of text 
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Why some software se 
more than others. .2¢ 


Nervously, Simon sipped 
his coffee. His hands shaking 
as his eyes darted the room. 
“No. I didn’t think I 
needed to.” 

Don’s chair slid 
out from under 
him and he crashed 
to the floor. Amazed 
in disbelief, Don cried, “You 
What?!” Grabbing his tattered 

scrapbook, Don 
pulled out photos 
of his travels. “Ever 
been to Seoul? 
Prague? Anywhere? 
Ten bucks will buy 
you anything, even 
bootlegged copies of software.” 


Don's Road to Success 


uccess. All software 
developers strive 
for it. Now, Don 
Gall was on top of 
the world. Software 
protection made 
all the difference. 
Especially in 
Europe and Asia. 
Sales were four times 
better than before. He is 
the founding father of 
Sentinel — the guru of 
software success, 
Struggling 
Software Sales 
One day, trekking through 
the coffee fields of Java, 
Don ran into his old college 
buddy Simon Seagull. “Don, 
my sales are well below Thumbing through the 
expectations.” Simon scrapbook, Don shared his 
explained his plight, “My experiences. “Back in the 
software should sell like ‘80s, I was in your shoes — 
yours, Don!” Yet despite beaten, battered 
critical acclaim Simon’s and bruised.” 
company, SimonSays Simon listened. 
Software, teetered ona “Then, after 
financial tightrope. “What's a heart breaking 
your secret, Don?” tiparoundthe 4 
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They looked at everything. “T could hardly believe 
The Key to the Problem it. They told me developers 
Finally, Don leaned back lose billions of dollars each 
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question, “What about software. In some countries 
protection — are you using there are nine pirated copies 
Sentinel?” for each legal copy sold.” 


Simon was disgusted, “It’s just 
not fair.” 
“That’s why I committed 
myself to solving the 
piracy problem,” 
explained Don. 
_ Simon’s eyes lit 
“up. “The dongle!” 
he shouted, Don 
corrected him, “Not just any 
dongle — the dongle that 
paved the road to success 
for over 10,000 developers 
worldwide — Sentinel.” 
Successful Developers 
Use Sentinel 
Don pulled a stack of letters 
out of his gunny sack. “All 
of these people tell the same 
story.” Don read about a 
successful developer from 
California who swears she 
wouldn’t be in business 
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Guide to Securing 
Software.” Or better 
yet, ask him for a low 
cost Sentinel Evaluation 
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without Sentinel. Another 
company says protection costs 
less than litigation, plus 

they don’t have to 
* spend time and 

money supporting 

illegal users. 

Others confessed 
they wouldn’t market 
products internationally 
without protection. 

The hours flew by, story 
after story, Simon learned 
Don Gall’s secret. To succeed 
is to protect. To protect is to 
secure with Sentinel. 


For your free guide to securing 
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or distributor listed below. 


Sena inel 
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for (c=0x80 ; c ; 
{ 
if ((colour&c) ==(octet&c) ) 
run_length++ ; 
else 
colour ? 
nextwhite () 


e>>=1) 


:nextblack () ; 


Figure 5 - 
Dismantling octets of eight bits 
and calculating run lengths 


Encoding the bit image 


Once you've digitised your line of text, 
the real fun begins. On the surface, the 
T.4 specification ought to make turn- 
ing lines of dots into encoded lines of 
fax data quite simple. However, the 
point about the codes in Figure 2 is 
that they aren’t binary values, but se- 
quences of bits. They don’t fit neatly 
into bytes, as they have variable 
lengths, and they can’t be padded out 
to bytes at either end as that would 
falsify the coding. For example, a 
white run of two is 0111 and if padded 
out with leading zeros it turns into a 
black run of 14, which is 00000111. If 
padded out with trailing zeros, the 
code following would be invalidated - 
a black run length of four (011) would 
become 0000011, which is the code for 
a run length of 22. 


This may seem to be a total pain in the 
neck, but there’s a fair amount of logic 
in the way the system works. Variable 
length codes chosen on the basis that 
the most frequent occurrences should 
have the shortest lengths really does 
shorten transmission times substan- 
tially, as Samuel Morse demonstrated 
practically about the time that Babbage 
was trying rather less practically to get 
his differential engine working. If you 
think about the way that text appears 
on a sheet of paper, you begin to 
realise that short run lengths of black 
are generally interspersed with slightly 
longer run lengths of white, with long 
black runs being very uncommon 
compared to long white runs. The 
codes chosen are optimised for send- 
ing printed (black on white) text in the 
shortest time. 


What we need to do is discard the idea 
of each byte of bit-image data being 
meaningful and instead to treat bytes 
as octets of eight individually meaning- 
ful bits which only happen to be 
grouped in eights for convenience. 
After all, while we are trained as pro- 
grammers to think in a ‘byte-ist’ man- 
ner, this isn’t necessarily the only way 
to organise information. It is unfortu- 
nate that most of the programming 
tools we work with incorporate similar 
byte-ist assumptions, and the higher 
level the language, the more difficult it 
is to encode and decode fax data. 


Back to the task in hand. We've turned 
a single line of text into a bit image 
containing 16 rows of dots, which all 
end with a unique sentinel. We have 
to encode each of these sixteen rows 
into the correct fax form, which means 
that we need to identify and count 
consecutive sequences of 0 bits (white 
runs) and 1 bits (black runs) in each 
rows. We need keep track of both the 
colour of the run we are counting and 
the number of bits we have counted in 
the current run length. The principle is 
that we look at each bit in turn: if it 
matches the colour of the current run 
we increment the count, but if it’s a 
different colour we need to end the last 
run (encoding the count for the last 
colour) and start a new run with the 
other colour. 


Getting at the bits in a byte is a doddle 
in virtually any assembler - just rotate 
a byte to the left eight times and look 
at the carry flag to find out the colour. 
While no high-level languages in com- 
mon use give you access to a carry flag, 
there are a number of ways of tackling 
the problem which don’t require one. 
The traditional method is via eight 
logical ANDs, which is easily done in 
most languages. This could be coded 
either iteratively, simply for ANDing a 
byte successively with 128, 64, 32, 16, 
8, 4, 2, and 1, or else as a loop, by using 
an 8-bit unsigned integer initialised to 
128 and either shifting right one bit or 
else dividing by two until the result is 
0. The loop would of course execute 
slightly slower, but is used in the frag- 


if (run_length>63) 
{ 


run_length8=64 ; 
} 


shiftin (&blackmakeup[(run_length/64)-1]) ; 


shiftin (&blackrun[run_length]) ; 


Figure 6 - Using run lengths as indices to fax codes arrays 
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Fax 


ment in Figure 5 as it is more conven- 
ient for illustration. It’s important to 
note that using this method, the vari- 
able colour must contain either 
Oxff for black or 0x00 for white - 
look up a text on boolean algebra if 
you aren’t sure why this is necessary 
or how it works. 


Encoding Run Lengths 


Figure 5 uses two complementary 
functions, nextwhite() and 
nextblack(), to handle the case 
where we have ended one run length 
and begun another. We can obtain the 
code for the run length we have just 
finished by keeping the codes in an 
array and using the run length to de- 
rive an index into the correct table. If 
the run length is greater than 63, we 
do the necessary arithmetic to get hold 
of the make-up code followed by the 
remaining terminating code. The code 
fragment in Figure 6 illustrates this 
being done with a black run length, 
which of course would be part of the 
nextwhite() function. 


That’s all quite straightforward: what 
isn’t quite so obvious is the best way 
of storing all the codes from Figure 2 
in the data section of the program. The 
problem is the same one we encoun- 
tered when encoding, as we have to 
avoid values such as black runs of two 
(1D, of four (011), of five (0011) and 
of seven (00011) as well as the code 
for a white run of 13 (000011) being 
stored as identical values. 


Of the different ways of overcoming 
this problem, the most straightforward 
to use and quickest to execute is to 
store the set of codes as four arrays 
consisting of the count of bits in the 
code followed by the code itself pad- 
ded out at the least significant end. A 
two-dimensional integer array would 
work quite well, but a more efficient 
way in C is to store the data as a simple 
structure array. The structure declara- 
tion would look like this: 


struct huffdef 
{ 
unsigned char count; 
unsigned short int values; 
Pg 


and a code such as the one for a white 
run of 3, which has bit sequence ‘1000’, 
would be stored in the form 
4,0x8000. As we'll see, it’s worth 
padding out on the right - once again, 
getting the data organised correctly 
makes the code easier to write. 


DTHAD2 


for ( ; 
{ 
if (padded_code&0x8000) 
fax_file(current_byte] |=1 ; 
else 
fax_file[current_byte] &=0xfe 


bit_count ; bit_count--) 


padded_code<<=1 ; 

if (!(--spare_bits) ) 

{ 
++current_byte ; 
spare_bits=8 ; 

} 

else 
fax_file(current_byte]<<=1 ; 


Figure 7 - Shifting variable 
length bit codes into bytes 


Creating the file 


The lowest level part of the code takes 
the address of the correct element of 
the code array as a parameter. Its sole 
job is shifting the right number of bits 
into the fax in the right order. While 
this is the trickiest part of the whole 
process to code in any byte-oriented 
language, it is made much simpler 
when we have access to the number 


of bits in the code we want, and the 
code itself is held in a 16-bit word 
padded out at the right. All we need to 
do is to loop for the number of bits in 
the code bit_count, shifting one bit 
at a time out of the left of the right 
padded code word and into the right 
of the current byte of the fax file we 
are encoding. A static variable 
(spare_bits) keeps track of the 
number of bits we have available in 
the current byte. A suitable code frag- 
ment is listed in Figure 7. It checks the 
high bit of the code word by ANDing 
it with 0x8000 and uses the result to 
set the low bit of the current byte to 
either 1 by ORing it with 1, or to 0 by 
ANDing it with Oxfe. 


It is probably a good idea to make sure 
that, if an EOL code is being shifted in, 
it ends on a byte boundary. This en- 
ables encoded lines to be written out 
to the fax file on disk as they are 
generated. The T.4 specification makes 
this easy, as any number of fill bits 
(value 0) can precede an EOL code. 


All the rest of the code needed to write 
a program to generate fax images from 
text files should be quite straightfor- 


Fax 


ward, Next month we move on to 
decoding, sending and receiving fax 
data. 


(To be continued...) 


EXE 


Andrew Margolis runs a software 
house and consultancy specialising in 
communications, emulations, fax, 
EPOS and utilities for a wide range of 
systems. He can be contacted at Mar- 
golis & Co on O81 889 7755. 


If you don’t feel like writing fax han- 
dling code yourself, Andrew has made 
the (Borland and Microsoft C) binaries 
of his fax software available on a 
shareware basis. Registration, which 
costs £30 CA real bargain!’ - A Mar- 
golis), buys you the full C and assem- 
bler source for encoding, decoding, 
sending and receiving faxes. For a free 
copy of the object code, please see the 
dotexe/files topic on CIX, or send 
us a disk and SAE, following the in- 
structions given in column 1 of the 
Contents Page. Please mark your enve- 
lopes ‘FAX’. To register and obtain the 
source, please contact Andrew direclly.. 
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Abstract Syntax 
Notation One 


Chris Adie presents a mechanism for sending and receiving complex data structures 
in a machine-independent manner. 


Have you ever had to transfer binary 
data between computers with different 
architectures? Apart from the actual 
mechanism of communicating the 
data, the most important problem is 
that of data representation. Ideally, 
you need to be able to transmit an 
arbitrarily complex data structure in a 
machine-independant format, without 
concern for issues such as word size, 
byte order, or structure alignment. 


The Open Systems Interconnection 
(OSD seven-layer protocol suite deals 
with the question of data representation 
at layer 6, the Presentation layer. It 
defines a language called ASN.1 (Ab- 
stract Syntax Notation One) which is 
explicitly designed to make it easier to 
transfer data between dissimilar com- 
puter systems. In fact, ASN.1 is not just 
a part of the OSI Presentation layer - it 
is used by all Application layer (layer 
7) protocols such as X.400 (electronic 
mail) and FTAM (file transfer). Increas- 
ingly, it is finding uses outside OSI too. 


ASN.1 is not a programming language 
in the way that C or Pascal is - it does 
not consist of executable statements 
and you can’t speak of ‘an ASN.1 pro- 
gram’. Instead, it is concerned with 
defining data types and how values of 
these types are represented as a stream 
of bytes which can be transferred be- 
tween two systems. We will start off by 
examining ASN.1’s Basic Encoding 
Rules, which specify how an arbitrary 
data structure can be represented as a 
byte stream. 


Basic Encoding Rules 


Let’s see how we might represent an 
array of integers in such a byte stream. 
For a single integer, the most compact 
representation is just the two’s comple- 
ment binary form, so 100 decimal is 
represented just by: 

64 

(we'll use hex for byte streams). For 
integers greater than 127 and less than 
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-128 we need more than one byte. The 
question is: do we output the least 
significant, or the most significant byte 
first Cie little-endian or big-endian)? 
There is no compromise which is in- 
dependent of processor architecture, 
so we'll arbitrarily choose to output the 
most significant byte first. 513 decimal 
is therefore represented as: 


02 01 


When we have an array of such inte- 
gers, we need some way to specify 
where one integer value ends and 
another begins. So, let’s prefix each 
integer by a byte indicating the num- 
ber of bytes required to stored it. The 
three element array 63, -1, 258 would 
then look like: 


01 3F 01 FF 02 01 02 


Now, for reasons that will become 
apparent later, we're going to precede 
each length byte with an 02 identifier 
byte, to signify that the type of the data 
to follow is integer. So for our three- 
element array, the byte stream looks 
like: 


02 01 3F 02 01 FF 02 02 
O1 02 


In order to indicate that these three 
integers form an array, we'll preceed 
them with an array identifier byte (3 0) 
and a length byte (0A). So the final 
byte stream encoding for the three 
integer array 63, -1, 258 is: 

30 OA 02 01 3F 02 O01 FF 

02 02 01 02 


We could create a file containing these 
twelve bytes or we could transmit 
hem on a network. The system which 


read the file or received the bytes from 
the network would be able to decode 
them without having to know anything 
about the word length or processor 
architecture of the system which cre- 
ated the byte stream. 


What we've developed in the last few 
paragraphs is the basis of a set of rules 
for encoding data structures in a proc- 
essor-independent way. In fact, these 
Basic Encoding Rules are defined and 
published by the telecomms regulator 
CCITT (as recommendation X.209) 
and also by the International Standards 
Organisation (as International Stand- 
ard 8825). The ASN.1 language itself is 
defined in International Standard 8824 
and addenda, and also in CCITT Rec- 
ommendation X.208. 


Every data item encoded according to 
the Basic Encoding Rules comprises an 
identifier, followed by a length, fol- 
lowed by the contents of the data and 
optionally terminated by an ‘end of 
contents’ (EOC) marker (see Figure 1). 
The identifier contains a ‘tag’ which 
gives the type of the data item and a 
flag to indicate whether the data item 
is ‘primitive’ (ie the contents bytes are 
a basic type such as an integer or a real 
number) or whether it is ‘constructed’ 
(ie a C structure where the contents 
bytes themselves comprise BER-en- 
coded data items). Figure 2 shows how 
the identifier is made up. 


The tag attached to a data item can be 
one of four classes, as indicated by bits 
6 and 7 of the identifier. Universal class 
tags are used for common data items 
such as integers, strings, arrays and so 


Identifier Length 
byte(s) byte(s) 


Contents 


Optional 
EOC mark 


Figure 1 - A data item using the Basic Encoding Rules 
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> CIRCLE NO. 902 


7 Pies ir sah ce 5 4 3 2 
les ere number 
00 Universal 0 = Primitive 


01 Application 
10 Context specific 
11 Private 


1 = Constructed 


Figure 2 - Structure of the first identifier byte. 


forth (see Table 1). Private class tags 
may be defined by an organisation to 
indicate organisation-specific data 
types. For instance a bank might define 
a private tag to indicate that the en- 
closed contents represent a sum of 
money. Application class tags are used 
within the context of a particular ap- 
plication - ie electronic mail. And Con- 
text-specific tags are used to 
distinguish between otherwise identi- 
cal types inside a constructed type. We'll 
see several examples of context-specific 
tags shortly. 


The tag value can be anything from 0 
upwards. If it is less than 0x1F, it is 
represented in the bottom five bits of 


Type Tag (hex) | Encoding * 
BOOLEAN 01 [7 
INTEGER 02 P 
BIT STRING 03 PIC 
| OCTET STRING 04 PIC 
NULL 05 [2 
| OBJECT IDENTIFIER — |06 li2 | 
ObjectDescriptor 07 P | 
EXTERNAL 08 Cc 
REAL 09 P 
ENUMERATED 0A P 
SEQUENCE [OF] 10 @ | 
SET (OF] 11 (0 
NemericString 12 PIC 
PrintableString 13 PIC 
TeletexString 14 PIC 
VideotexString 15 PIC 
1A5String 16 PIC 
UTCTime 17 P 
GeneralizedTime 18 P 
|| GraphicString 19 PIC 
VisibleString 1A PIC 
GeneralString 1B PIC 


*P = Primitive Type 
C = Constructive Type 


Table 1 - Built-in ASN.1 types 
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the identifier byte. The value 0x1F 
indicates that the identifier uses more 
than one byte - the tag is carried in 
subsequent identifier bytes. 


The length bytes also have an internal 
structure. In fact, for constructed types, 
a method of encoding can be used in 
which the length is simply the single 
byte 80: the contents are delimited by 
the end-of-contents marker, made up 
from two consecutive 00 bytes. This is 
called ‘indefinite encoding’ and is used 
when you don’t know the length of the 
encoded data before it is transmitted. 
The other method, ‘definite encoding’, 
takes two alternative forms. The first of 
these can be used when the length of 
the contents is 127 bytes or less - ie the 
length can be represented by a single 
byte. The second form is used for 
greater lengths. Here the first length 
byte has the top bit set, and the remain- 
ing 7 bits indicate the number of sub- 
sequent bytes which comprise the 
actual length of the contents. For in- 
stance, two possibly encodings of the 
integer 7 are: 


02 01 07 
or equivalently: 
02 84 00 00 00 01 07 


In the second form, four bytes are used 
to represent the length, preceded by 
one ‘length of the length’ byte. Note 
that both these encodings are fixed 
length, since integers are primitive 
types. But indefinite length encoding 
can be used with constructed types 
such as arrays: 


30 80 02 01 07 00 00 


This is an array containing a single 
integer, value 7. The array is encoded 
in indefinite length form. (Note that the 
end-of-contents marker is actually a 


ASN. 1 
primitive type with a tag of 0 and a 
length of 0.) 


Data Types 


In order to describe the complex data 
structures which we are now able to 
encode and decode we need some 
kind of data description notation. We 
could simply use C typedefs or 
Pascal records - but these have no 
natural way for representing tags. Also, 
certain data types (such as C arrays) 
can be specified in more than one way, 
obscuring the data description. 


ASN.1 lets you specify data types of 
arbitrary complexity which map onto 
the Basic Encoding Rules in a very 
natural way. Figure 3 shows some 
simple ASN.1 type definitions, together 
with equivalent C typedef statements. 
Three types are defined: Currency is 
an enumerated type; Amount is a SE- 
QUENCE (equivalent to a C struct) 
containing two components - cur- 
rency (of type Currency) and sum 
(of type INTEGER) and Amounts is 
an array of Amount (arrays are de- 
noted by SEQUENCE OF in ASN.1). 
Note that types in ASN.1 start with a 
capital letter while component names 
start with a lower case letter. Figure 4 
illustrates the encoding of Amounts. 


ASN.1 data types 
Currency ::= ENUMERATED { 
pounds (0), 
us-dollars (1), 
german-marks (2), 
yen (4) 
} 


Amount ::= SEQUENCE { 
currency Currency, 
sum INTEGER 

} 


Amounts ::= SEQUENCE OF Amount 


C equivalents: 


typedef enum { 
pounds=0, 
us_dollars, 
german_marks, 
yen=4 

i 

Currency; 


typedef struct _Amount { 
Currency currency; 
int sum; 

} Amount; 


typedef Amount Amounts [80]; 
/* NB: C, unlike ASN.1, */ 
/* vequires array size */ 


Figure 3 - Some simple ASN.1 
types and their C typedef 
equivalents. 
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30 80 SEQUENCE OF 
30 80 SEQUENCE 
OA 01 00 pounds 
02 02 03 E8 1000 
00 00 end of SEQUENCE 
30 06 SEQUENCE (definite length) 
OA 01 02 german-marks 
02 01 C8 200 
00 00 end of SEQUENCE OF 
(Byte stream is shown broken up and indented for ease of interpretation) 


Figure 4 - Encoding for £1000 and DM200 Amounts 


The tag for SEQUENCE and SEQUENCE 
OF are the same - this reflects the fact 
that in C (or any other programming 
language) an an array can be treated 
as a struct with a number of identi- 
cal fields. Also notice that we can mix 
definite and indefinite encoding - the 
first Amount is encoded with indefi- 
nite length, the second with definite 
length encoding. 


As well as SEQUENCE and SEQUENCE 
OF, we can use SET and SET OF. The 
difference is that in a SEQUENCE the 
order of the components is significant, 
whereas in a SET they may be en- 
coded in any order. For instance, if we 
had defined Amount as a SET, then 
we could have encoded £1000 as: 


31 80 02 02 03 E8 OA 01 
00 00 00 


Figure 5 is a complete ASN.1 module 
which illustrates some more features 
of the language. A module starts with 
the module name, followed by the 
symbols DEFINITIONS ::= thena 
BEGIN/END block which contains the 
body of the module. In order to refer- 
ence types defined in some other mod- 
ule, we use the IMPORT statement to 
make it available. Similarly, to make a 
type defined in this module available 
to other modules we name it in an 
EXPORTS statement. 


The module SomeBankingTypes 
defines just one type - Account Bal- 
anceReport (intended to represent 
a message which might be sent by a 
central bank computer) which is a 
SEQUENCE containing a number of 
components. The first component, 
bank-sorting-code, is marked 
with the keyword OPTIONAL, indicat- 
ing its possible absence from a particu- 
lar value of this type. It is of type 
VisibleString, which is essen- 
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tially the ASCII character set. (ASN.1 
has a number of character string types 
built in - they are mostly subsets or 
extensions of ASCII.) 


The [0] in the definition of the bank- 
sort ing-code component indicates 
that this component is encoded with a 
context-specific tag of 0. By default, 
this is in addition to the Universal class 
tag associated with the Visi- 
bleString. The purpose of tagging 
components in this way is to make it 
absolutely clear which component is 
which - very necessary if the SE- 
QUENCE contains a number of identi- 
cal types, some of which are optional. 


The next component, account -id, 
is a CHOICE between two alternatives. 
The meaning is obvious - one and only 
one of the types in a CHOICE may be 
present in a particular value (ie a C 
union). The CHOICE does not have 
a tag of its own. Clearly, the tags of the 
individual choices must be distinct, to 
avoid ambiguity in an encoded value. 


Let’s look at a particular value of Ac- 
countBalanceReport, encoded in 
a byte stream. Figure 6 shows how the 
byte stream is made up. Notice how 


ASN.1 


we can choose either definite or indefi- 
nite length when encoding context- 
specific tags. It is only the innermost 
(primitive) data which must use defi- 
nite length encoding. 


Compilers 


So, now we have a powerful notation 
for defining data types and an unam- 
biguous and machine-independent 
way to represent values of these types 
as a byte stream, What we now need 
is a way to translate the ASN.1 types 
into C structs (or Pascal records) 
and a means of automatically encoding 
and decoding a bytestream. This is the 
role of an ASN.1 compiler. 


ASN.1 compilers are available from 
several different suppliers, but they all 
work in slightly different ways. One of 
the most popular is the compiler from 
Open Systems Solutions (Princeton, 
New Jersey), which targets the C lan- 
guage. The input to the compiler is one 
or more ASN.1 modules. Output con- 
sists of a C header file containing 
typedefs and #def ines which cor- 
respond to the ASN.1 types and a table 
(in the form of a statically initialised 
array) which is used for encoding and 
decoding the byte stream. 


Writing the application involves #in- 
cluding the compiler-generated 
header file; setting up the required 
structs in memory and calling the 
OSS encoder (supplied in a linkable 
library with the compiler) to create the 
byte stream. The encode routine uses 
the table produced by the compiler to 
construct the byte stream. Similarly, 
there is a decode routine which con- 
verts a byte stream into C structures. 


The OSS compiler offers a great deal 
of control over the type of C structures 
which are generated. 


SomeBankingTypes 


AccountBalanceReport ::= 
bank-sorting-code 
account-id CHOICE { 

account-name [1] 
account-number [2] 
i 
balance [3] Amount 
} 
END 


DEFINITIONS ::= 


IMPORTS Currency FROM SomeOtherModule 
EXPORTS AccountBalanceReport 


SEQUENCE { 
{0] VisibleString OPTIONAL, 


VisibleString, 
NumericString 


BEGIN 


Figure 5 - A complete ASN.1 module 
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> CIRCLE NO. 904 


30 80 SEQUENCE 
AO 0A (0) 
1A 08 38 30 2D 33 31 2D 32 35 VisibleString "80-31-25" 
Al 80 {1] 
1A 07 4A 2E 53 6D 69 74 68 VisibleString "J.Smith" 
00 00 end of [1] 
A3 0B (3) 
30 80 SEQUENCE 
OA 01 00 ENUMERATED pounds(0) 
02 02 03 E8 INTEGER 1000 
00 00 end of SEQUENCE 
00 00 end of SEQUENCE 
(Encoded value of type Account BalanceReport: £1000 in account called J.Smith at 
branch 80-31-25). 


Figure 6 - Definite- and indefinite-length encoding. 


Identifiers and Syntax 


One of the built-in types in ASN.1, with 
a Universal class tag of 6, is the OB- 
JECT IDENTIFIER type. An object 
identifier is simply a finite series of 
integers, with the first in the series 
restricted to 0, 1 or 2 and the second 
restricted to the range 0-39 inclusive 
with any non-negative integer possible 
subsequently. Conventionally, they 
are written in curly brackets, or else 
with full stops between them, thus: 


{2: 3) 6 1, 103 
or: 
Die SiO vide. LO 


Object identifiers are used as names 
for various ASN.1 constructs - ie source 
modules can have their own object 
identifiers. The thing that makes them 
so useful is that they form a single, 
unified, infinite name space with a 
hierarchical structure which facilitates 
distributed naming. Object identifiers 
which start with 0 are allocated by 
CCITT, those starting with 1 are allo- 
cated by ISO, while those starting with 
2 are allocated by ISO and CCITT 
jointly. 


SO and CCITT then allocate the next 
integer in the object identifier for vari- 
ous purposes - eg ISO allocates 0 to 
represent its international standards, 
so that 1.0.8824 is the object identi- 
fier for International Standard 8824. 
Both ISO and CCITT offer a way for 
organisations to obtain an object iden- 
tifier, which they can then use as the 
basis of a naming tree. 


One of the objects which are named 
using identifiers is an ‘Abstract Syntax’. 
This is simply a collection of related 
ASN.1 type definitions in one or more 
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modules. (Hence the name Abstract 
Syntax Notation - but note that the ‘1’ 
in ASN.1 has no semantic content: it 
simply reflects a penchant for number- 
ing things!) Syntax in ASN.1 is ‘abstract’ 
in the sense that it conveys nothing 
about how the data is represented 
inside a particular computer. A ‘Con- 
crete Syntax’, on the other hand, is a 
corresponding collection of data struc- 
tures, in assembler, C, or some other 
language, which is a more direct rep- 
resentation of the data in terms of a 
particular computer architecture. 


There is a third type of syntax - a 
‘Transfer Syntax’. Since there’s no rea- 
son why the Basic Encoding Rules 
which we have been discussing should 
be the only way of representing data 
values in a byte stream, other sets of 
encoding rules with different proper- 
ties are available. So one set of encod- 
ing rules may incorporate encryption, 
for instance, while another sacrifices 
compactness for ease of use. A set of 
encoding rules is called a Transfer 
Syntax, and has its own object identi- 
fier. The object identifier for the Basic 
Encoding Rules is 2.1.1. 


It is essential that if two systems are 
using ASN.1 to communicate, they 
should agree on the abstract syntax 
and the transfer syntax in use. If the 
communication is via a file which is 
written on one system and read on 
another, prior agreement on the syn- 
taxes is necessary. But if the commu- 
nication is real time (ie using a 
network), syntaxes can be negotiated 
by sending the corresponding object 
identifiers between the systems before 
data exchange proper starts. The pair- 
ing of an abstract syntax and a transfer 
syntax is known as a ‘presentation 
context’. The OSI Presentation layer 
protocol’s main function is to figure 
out what presentation context to use. 


ASN.1 


Conclusion 


Although ASN.1 is very good at its job 
of providing a machine-independant 
syntax for exchanging data, like most 
languages it is not so hot at repre- 
senting the semantics of data types. 
Because of this, it can be difficult to 
make sense of ASN.1 modules in the 
absence of accompanying comments 
or explanatory text. 


ASN.1 is popping up all over the place. 
The TCP/IP-based Simple Network 
Management Protocol (which is cer- 
tainly not OSD uses ASN.1 extensively, 
as does the Kerberos security protocol. 
ASN.1 is also used in the Open Docu- 
ment Interchange Format (ODIF) and 
for multimedia/hypermedia data, in- 
cluding digital video. If you have a 
requirement to exchange data be- 
tween dissimilar computers, either 
across a network or using a file-based 
mechanism, you should certainly con- 
sider whether ASN.1 fits the bill. 
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Volume 15 and 16 of the “EXE Disks’ are now available. 


Packed full of public domain utilities and programs, many with full source code, the new 
-EXE Disks are ideal for any Windows Programmer. Each 3.5" disk contains 700k of compressed files, 
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MULTIP 

Here is an example program which illustrates the 
power of the Microsoft Foundation Classes (MFC). 
The program is a fully working programmer’s editor 
with multiple windows, Print & Printer Setup dialog 
boxes and a Cut & Paste facility. Other features in- 
clude Search & Replace, Find Next/Previous and 
Tile/Cascade for rearranging windows. With over 55 
KB of source, MULTIP provides a thorough founda- 
tion for building your own MFC applications, 
especially MDI apps. (Public Domain) 


PREVIEW 

It is often necessary to determine which fonts are 
available to the system, PREVIEW is a 500-line 
TPW program which will show you how to do this 
using OWL. The code provides plenty of examples 
on font manipulation, and is an ideal starting point 
for writing applications such as Windows text edi- 
tors. (Public Domain) 


ULTRACLIP 

The problem with the Windows 3.1 clipboard is 
that it only lets the user copy one object at a time. 
ULTRACLIP is a utility which allows you to store 
as many objects on the clipboard as your tem 
memory will allow. Each time an object is copied 
to the clipboard, ULTRACLIP creates a new win- 
dow and copies the object into it, Full TPW source 
is included, (Shareware) 


PROFFT 

PROFFT is a Public Domain image processing 
package for Windows which gives remarkable per- 
formance using the Fast Fourier Transform (FFT). 
After a Windows bitmaps (.BMP) has passed 
through the FFT, PROFFT provides the user with 
a total of 7 filters for enhancing the image. Includ- 
ing Low pass, High pass, Band pass, Butterworth 
Low & High pass and a freehand filter. Complete 
OWL C++ source included. (Public Domain) 


MASKED EDIT 

Try this. Go into Windows Control Panel and se- 
lect ‘Ports’, then ‘Settings’. Now type in 
your name in the ‘Baud Rate’ edit field. See 
the problem? That’s a numeric field, yet Windows 
doesn’t stop Snoopy from keying in ‘Charlie 
Brown’. This C++ class for OWL enhances the 
standard edit field by allowing the developer to 
specify a Filter containing characters which are 
acceptable as input. MASKED EDIT comes with 
BC++ project and source files and an example im- 
plementation, (Public Domain) 

TXT2RTF 

Before you can start creating your own Windows 
Help files, you’ve first got to buy a wordprocessor 


Ref: E 3 


your details. 

| WOULD LIKE: (please tick relevant boxes) 
(quantity) Volume 15 Disk(s) @ £9 

(quantity) Volume 16 Disk(s) @ £9 


| enclose a cheque for £. 


Debit my VISA/ACCESS Card by &. 
Card No:. 
Signed:....... 


The disks are excellent value for money at only £9.00 incuding VAT. 
To order, complete the form below, or call 081 994 6477 ext 2338 with 


Please add £1.50 P&P for up to 4 disks - or £2.50 for more than 4 disks 


-EXE and Basic Magazine as the best of the thousands of items currently available. £9 per 3.5" disk. 


like MS Word for Windows which can produce 
Rich Text Format (RTF). Alternatively, you could 
use this DOS-based utility to convert a standard 
ASCII text-file into a RTF file. Special ASCII 
characters are embedded in the text file in order to 
specify Help features such as Titles, Keyword, 
Cross References etc. The text file can also refer- 
ence bitmaps. TXT2RTF comes with an example 
project for BC++. (Public Domain) 


WIZUNZIP V1.1 

WIZUNZIP is a good-looking Windows-based 
clone of the popular PKUNZIP DOS utility for ex- 
panding .ZIP files. It comes with comprehensive 
context-sensitive Windows Help and over 350 KB 
C source. (Public Domain) 


VISUAL LIB 

The Windows 3.1 GDI is rather primitive when 
compared to the graphics API in Windows NT 
(when it’s finally released), Visual Library for BC++ 
extends the GDI now, It contains powerful curve and 
surface drawing functions including: Bezier, Hermit 
Curves, B-Spline, and NURBS curves and surfaces. 
‘There are also functions for drawing several types of 
graphics object such as Polygons, Ellipses, Spheres 
and Polyhedra, (Shareware) 
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DLLMAKER 

This is a TPW utility for assembling a set of 
units into a DLL, It takes a unit’s interface sec- 
tion(s), and generates two new fil a ‘binderey 
unit’, which repeats all type declarations and im- 
plements all procedures as externals in the DLL, 
and an ‘export library’, which explicitly exports 
public procedures and object methods. (Share- 
ware) 

EDI THREADS 

Threading is the mechanism by which a program can 
be made to perform several actions simultaneously. 
Previously threads were linked with high-powered 
32-bit operating systems such as Windows NT and 
OS/2, but EDI THREADS brings multi-threading 
into the world of Windows 3.x programming. The li- 
brary is distributed as a DLL with BC++ and TPW 
interfaces. (Shareware) 


HEAP AUDITOR 

Failure to free resources is a common headache 
in Windows programming and is extremely diffi- 
cult to track down. HEAP AUDITOR is a utility 
which displays various statistics about the GDI, 
Global and Local Heaps. By checking the report 
before and after the program under examination 
has been run, a developer can determine whether 
memory leaks have occurred, (Public Domain) 
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WINDOWS KERMIT 
This is a Windows-hosted terminal emulator 
which enables the user to upload and download 
files to/from remote servers using the widely avail- 
able Kermit file transfer protocol. The package 
includes substantial support for VT100 and VTS2 
terminals and comes with over 400 KB of C 
source which can form the basis of a full-blown 
comms package. (Public Domain) 


NNTPW 

The Novell NetWare API can easily be invoked 
from a DOS applications, but it is more difficult to 
access in Windows. NNTPW is an example pro- 
gram written in TPW from the November *92 
issue of .EXE which illustrates how it’s done. 
(Public Domain) 


OWLBWCC 

OWLBWCC is a group of 18 example programs 
(with full source code) for using Borland custom 
controls (BWCC) with OWL, The examples in- 
clude: how to create a basic BWCC dialog box 
with metal background, group boxes, bumps and 
dips; how to use a large custom button as a splash 
screen and how to perform delayed processing. 
(Public Domain) 


IDLE 

In the December 1992 issue of .EXE Laine 
Stump described an extremely elegant way to 
perform background multi-tasking in Windows 
using a generic class derived from Microsoft 
Foundation Classes. IDLE contains the code 
from the article. There’s over 200 KB of source, 
including Laine’s MFC code for a thermometer 
custom control. IDLE is bound to teach you 
many new tricks, (Public Domain) 


XLMATH 

This is a DLL which extends Microsoft Excel by 
providing custom functions including diagonalizing 
a real symmetric matrix, creating a frequency dis- 
tribution and curve fitting functions. C source code 
is included for extending the DLL and the documen- 
tation looks into the difficulties with writing DLLs 
for Excel such as memory issues, Excel’s instance 
handle and Excel data types. (Public Domain) 


UNDOCFCT 

How can you be sure that the software you’re run- 
ning will be compatible with future releases of 
Windows? Many commercial Windows applica- 
tions rely on undocumented Windows API calls. If 
Microsoft alters these undocumented functions at a 
later date, such software may not function correct- 
ly. UNDOCECT is a utility which provides an 
early warning of potential incompatibility by print- 
ing all undocumented entry points and external 
references in a Windows executable. (Shareware) 
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Communicating with 
Workgroups 


Windows for Workgroups has already made an impact as a peer-to-peer networking 
environment. Resource sharing is fine for users, but what is there for the programmer? 


The growth of networking has had its 
effect on Windows. Windows for 
Workgroups has confirmed the trend 
towards peer-to-peer networking, 
either supplementing or replacing sys- 
tems based on file servers. 


Network protocol standards are 
emerging, allowing the developer to 
build heterogeneous networks from 
many combinations of workstations 
and servers. This is one of the founda- 
tions for client-server computing. 


What does this mean to you as a 
Windows developer? Let’s take a look 
at the various communication mecha- 
nisms available in Windows for Work- 
groups (abbreviated to ‘Workgroups’ 
for the rest of the article). 


Robert Seeman investigates. 


Architecture 


Workgroups offers peer-to-peer net- 
working services such as file and printer 
sharing. These services are fairly obvi- 
ous to the user. However, Workgroups 
also offers a wide variety of communi- 
cations services to programmers. 


The implementation of Workgroups 
follows the general strategy of layered 
communications protocols, in the spirit 
of the OSI seven-layer model, The 
protocol stack, NetBIOS session over 
NetBEUI transport over NDIS drivers, 
borrows heavily from existing DOS 
LAN Manager client software. (This 
simplifies integration of Workgroups 
with LAN Manager servers, which can- 
not hurt sales prospects for the latter). 


// AHEM.C - Simple alert program 
us using mailslots 

iw 

// usage: 
i 

// Requires LAN Manager toolkit to build 
V/s 


ahem (\\machinename] any message 


// LAN Manager Toolkit includes 


#define 
#define 
#include 


INCL_NETERRORS 
INCL_NETMAILSLOT 
<lan.h> 


// © run-time 


#include <stdio.h> 
#include <stdlib.h> 
#include <string.h> 


// Mailslot information 


#define MAILSLOT_NAME "\\MAILSLOT\ \AHEM" 
#define MESSAGE_CLASS 2 
#define MESSAGE_PRIORITY 5 
define MESSAGE_TIMEOUT 0 


// Entry point 
int main(int argc, char *argv(]) 


char * machine_prefix; 
char slot_name(128); 

// Message to send 

char msg (128); 

// API return code 
APILRET_TYPE uReturnCode; 
int i; 


// Check arguments 


if (argc==2 && strcmp(argv(1), "/?")==0 
£ 


fprintf(stderr, "ahem" 
" (\\Computername} any message\n") ; 
exit (0); 
} 


// Build message, check for \\ prefix 


machine_prefix=""; 
msg{0)="\0'; 
for (i=1; i<arge; i++) 
{ 
iff (is=1 && strstr(argv[1), “\\\\") 
=sargv(1]) 
{ 
machine_prefix-argv(1]; 
) 
else 
( 
streat (msg, argv(i]); 
streat(msg, " “); 
) 
) 
strepy(slot_name, machine_prefix); 
strcat(slot_name, MAILSLOT_NAME) ; 


// Send the message 


uReturnCode = DosiriteMailslot ( 
slot_name, // Mailslot name 
(void *)amsg, // Message to write 
strlen(msg)+1, // Length; allow for \0 
MESSAGE_PRIORITY, 
MESSAGE_CLASS, 
MESSAGE_TIMEOUT) ; 


// Check result code 
if (uReturnCode != 0) 
printf ("DosWriteMailslot error $u\n", 
uReturnCode) ; 


return uReturnCode; // Zero if OK 
d 


Figure 1 - AHEM.C 
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APIs 


Several of the DOS LAN Manager Cli- 
ent APIs have passed over to Work- 
groups with minor changes: 


@ Named Pipes 
@ Mailslots 
@ NetBIOS 


Although not part of the standard pro- 
tocol stack, Workgroups can also be 
configured with: 


@ NetWare IPX/SPX 
@ TCP/IP 


Workgroups also has Windows-spe- 
cific services: 


@ Network DDE 
@ Generic Windows network calls 


Several of these APIs can be used by 
both DOS and Windows applications, 
and can be used to communicate be- 
tween these two kinds of applications, 
whether or not they are running on the 
same workstation. 


Workgroups and NT 


Many of the facilities currently present 
in Workgroups will also be present in 
Windows NT, which, even in its stand- 
ard form, will have network capability. 
Windows NT is interoperable with 
Workgroups and many of the APIs are 
available on both platforms. 


However, it should be noted that Win- 
dows NT redefines a number of the 
APIs presented in this article, either for 
performance or security reasons. 


Waiting and Blocking 


How long does a network operation 
take to complete? This is a critical 
issue. It depends on a hundred and 
one variables: the physical data trans- 
fer rate, the current loading on the 


Put an end to software piracy! 


Meet the growing family of security keys Simply connect the appropriate key to a Simple. Unassuming, Ever vigilant. Easy 
from Software Secutity. single user computer, ora non-dedicated _ incorporate into your application 

i file server in a network, and you control all — package. And quite possibly the most 
Each one a specialist at enforcing your access to your protected application, profitable hardware investment a 


license agreement in virtually any user 


environment you can think of. Whether i's Users, however, won't even know it's there, Software developer can make. 


and LAN operations are unaffected, 


DOS,,UNIX, Macintosh or OS/2... whether The keys are transparent and won't To find out more, call: 
it's a single user installation or a LAN. impact software functionality or the ability 
to make back up copies. Normal node (0 784) 430060 
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Ail product names are trademarks or registered trademarks of their respective holders. 
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‘ Broken lines indicated using _ 
‘ space underscore sequence 


Begin Form FRM_AhemServer 


Caption = “Ahem! Server" 
Height 1080 

Icon AHEMSRV.FRX: 0000 
Left 1440 

LinkTopic "Form" 
ScaleHeight 675 

ScaleWidth 2520 

Top 1920 

Width 2640 


WindowState 1 ‘Minimized 
Begin Timer TMR_Poll 
Interval 
Left 
Top 
End 
End 
Option Explicit 


1000 
120 
60 


nun 


‘ Handle for the mailslot 
Dim hMail As Integer 


‘ Check the API return code for non-zero 
* and print error message if necessary 
* otherwise continue 


Sub APICheck (action As String, _ 
nResult As Integer) 
If nResult <> 0 Then 
MsgBox action & ": 
16, "Error" 
End If 
End Sub 


" & nResult, _ 


' Initialise - create mailslot 
Sub Form_Load () 
APICheck "DosMakeMailslot", _ 
DosMakeMailslot ("\MAILSLOT\AHEM", _ 
256, 0, hMail) 
End Sub 


’ Quit - delete mailslot 
Sub Form_Unload (Cancel As Integer 
APICheck "DosDeleteMailslot", _ 
DosDeleteMailslot (hMail) 
End Sub 


‘ Call at regular intervals to see if 
‘ a message has arrived at the mailslot 


Sub PollMailslot () 


Dim Buff As AHEM_MSG 
Dim nResult As Integer 
Dim bytesread As Integer 
Dim nextsize As Integer 
Dim nextprio As Integer 


' Check mailslot exists 
If hMail = 0 Then Exit Sub 


Do 
nResult = DosReadMailslot(hMail, Buff, _ 
bytesread, nextsize, nextprio, 0) 
If nResult = ERROR_Timeout Then 
‘ Nothing in mailslot 
Exit Do 
ElseIf nResult = 0 Then 
" Got something 


MsgBox Buff.Msg, , "Ahem!" 


Else ‘ Some error 
APICheck "DosReadMailslot", nResult 
End If 
Loop 
End Sub 


' Timer trigger 


Sub TMR_Poll_Timer () 
PollMailslot 
End Sub 


Figure 2; AHEMSRV.FRM listing 


network, and the activities of other 
machines to which you can be con- 
nected, to name a few. In the worst 
case, if your application waits for an 
incoming message and that message is 
never sent, a simple ‘receive data’ call 
can wait forever. 


In a true multi-tasking operating sys- 
tem there are no problems. It’s no 
problem for an application to be held 
up during a network call, because the 
OS will suspend (‘block’) the applica- 
tion until it can be completed, and 


' Mailslot API routines 


‘ Broken lines indicated using 
' space underscore sequence 


Declare Function DosMakeMailslot _ 
Lib "NETAPI" _ 
(ByVal 1pszName$, ByVal msgsizet, _ 
ByVal slotsize%, hMailt) As Integer 
Declare Function DosDeleteMailslot _ 
Lib "NETAPI" _ 
(ByVal hMail’) As Integer 
Declare Function DosMailslotinfo _ 
Lib "NETAPI" _ 
(ByVal hMail%, msgsizet, slotsizet, _ 
nextsizet, nextprio’, nMesg%) As Integer 
Declare Function DosPeekMailslot _ 
Lib "NETAPI" _ 
(ByVal hMail®, lpBuff As Any, _ 
cbReturnedt, cbNextt, _ 
nextpriot) As Integer 
Declare Function DosReadMailslot _ 
Lib "NETAPI" _ 
(ByVal hMail’, lpBuff As Any, _ 
cbReturnedt, cbNext%, nextpriot, _ 
ByVal timeout&) As Integer 
Declare Function DosWriteMailslot _ 
Lib "NETAPI" _ 
(ByVal lpszName$, lpBuff As Any, _ 
ByVal bufsizet, ByVal priot, _ 
ByVal classt, ByVal timeout&) As Integer 


Figure 3 - WFW.BAS listing 
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other applications will be dispatched. 
Many of the newer operating systems, 
eg OS/2 or Windows NT, permit mul- 
tiple threads per process, which allows 
the programmer a finer control over 
scheduling within the program. Multi- 
threading allows the programmer to 
allocate one thread to each communi- 
cation sub-task. 


However, current 16-bit implementa- 
tions of Windows are not preémptive; 
a blocked application holds up all the 
others - a serious problem. There are 
several potential solutions: 


@ ‘Block and be damned’. Applica- 
tions adopting this approach are not 
popular. 

@ Start the operation but do not wait 
for completion (most APIs allow 
this). Poll for completion using sys- 
tem idle time (using PeekMes- 
sage()) or at regular intervals 
(timers). 

@ Start the operation, and request an 
interrupt-time callback on comple- 
tion. This is very awkward because 
Windows is, on the whole, not reén- 
trant: with very few exceptions, you 
can’t make Windows calls inside an 
interrupt handler. 


For all but the most trivial of programs, 
the last two approaches should be 
used. An application must keep track 
of the current state of all connections. 
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For an application with many conver- 
sations this might involves state tables. 


Mailslots 


A mailslot is a one-way connectionless 
communication interface. One side of 
the conversation creates a mailslot to 
receive messages, and waits for a mes- 
sage. The other side writes messages 
to that mailslot. Each message is trans- 
mitted independently, and the order of 
delivery is not guaranteed. 


Mailslot names must have the form 
\MAILSLOT\x. When sending a mes- 
sage to a local mailslot, the program 
specifies a name in this format. When 
sending a message to a remote 
mailslot, the computer name is added 
to the front of the mailslot name, thus: 
\\MACHINE\MAILSLOT\x 


Traditional LAN Manager mailslot mes- 
sages have two ‘classes’. First class mail 
is guaranteed delivery: the write op- 
eration blocks until the message has 
arrived or a time-out expires. Second 
class message calls complete when the 
message has been successfully placed 
on the network or an error occurs. If a 
message is sent but could not be de- 
livered, the sender of the a second 
class message is none the wiser. 


Despite this drawback, second class 
messages have a number of uses: 


@ No time is spent sending acknow- 
ledgements, thus increasing effi- 
ciency. 

@ Any machine can receive second 
class messages (only a LAN Manager 
server can receive first class mes- 
sages). 

@ They can be broadcast across the 
workgroup, using an asterisk for the 
machine name. 


The mailslot API addresses the block- 
ing problem by specifying a time-out 
for calls which might block. An appli- 
cation can also use zero-length time- 
outs and poll for activity on the mailslot. 


Windows programs can access the 
Mailslot API through the NETAPI DLL; 
DOS applications have an INT 21 in- 
terface, for which the LAN Manager 
Programmer’s Toolkit has C bindings. 


Windows NT does not support the idea 
of mailslot message class - all messages 
are second class, and there are no 
time-outs or priorities. The API has 
been redefined to take account of 
these issues and also security. 


Make sure that 
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Call (0582) 487111 for more 
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SOFTWARE SECURITY 
MODULES 


Hardware devices (dongles) are a recognised and 
proven means of protecting software from 
unauthorised use and piracy. 
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Create Windows Help Files. 
Quickly, simply and efficiently. 


With the 
A.B.C. Help Builder for Windows 


The A.B.C. Help Builder is a complete application designed to 
produce the necessary files used by the Microsoft Help Compiler, 
version 3.0x and 3.1x. A word processor is not necessary. It is a 
simple to use tool for anyone who needs to produce professiona 
Help Files under Windows. Help Builder can be used to provide a 
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‘ Broken lines indicated using _ 
‘ space underscore sequence 


Begin Form FRM_Resources 
Caption “Windows Resources" 
Height 1680 
Left 960 
LinkMode 1 ‘Source 
LinkTopic “WinRes* 
ScaleHeight 1275 
ScaleWidth 5640 

1080 

5760 


Begin Timer TMR_! 
Interval 
Left 


Top 
End 


Gauge GGE_GDI 


= -1 ‘True 
= 315 

InnerBottom = 5 
InnerLeft = § 
InnerRight = § 
InnerTop = 5 
Left = 2100 
Max = 100 
NeedlewWidth = 0 
TabIndex Sod. 
Top = 720 
width = 3255 

End 

Begin Gauge GGE_User 
Autosize = -1 ‘True 
Height = 315 
InnerBottom = 5 
InnerLeft = 5 
InnerRight = 5 
InnerTop = § 
Left = 2100 
Max 100 
Needlewidth # a 
Tabindex = 0 
Top = 120 
Width = 3255 

End 

Begin Label GDI 
Height = 315 
Left = 1140 
TabIndex = § 
Top = 720 
Width 795 


End 

Begin Label User 
Height 315 
Left 1140 
‘TabIndex 4 
‘Top 120 


Width = 

End 

Begin Label 
Caption 
Height 
Left 
TabIndex 
Top 
Width 

End 

Begin Label LBL_GDI 
Caption 


LBL_User 


= 120 


Height 
Left 
TabIndex 
Top 
Width 
End 
End 
Option Explicit 


Declare Function GetFreeSystemResources _ 
Lib "User" _ 


(ByVal fuSysResource As Integer) As Integer 


Const GFSR_GDIRESOURCES = &H1 
Const GFSR_USERRESOURCES = &H2 


Sub TMR_Tick Timer () 
Dim U As Integer, G As Integer 


U = GetFreeSystemResources( _ 
GFSR_GDIRESOURCES 

GGE_User.Value = U 

User.Caption = U 


G = GetFreesystemResources( _ 
GFSR_USERRESOURCES) 
GGE_GDI.Value = G 
GDI.Caption = G 
End Sub 


Figure 4 - NETRES.FRM listing 


It would appear from experiments 
conducted using Workgroups that /o- 
cal second class mailslot messages do 
have guaranteed delivery, and can also 
be delivered even if no network cards 
are installed. This makes the mailslot a 
useful communication tool for com- 
municating between DOS sessions, or 
between DOS applications and Win- 
dows applications on the same ma- 
chine. 


The example programs AHEM and 
AHEMSRYV illustrate mailslots. AHEM 
(Figure 1), a DOS application written 
in C, writes messages to a mailslot 
called \MAILSLOT\AHEM, which can 
be on the local machine by default, or 
on a remote machine: this is specified 
by entering a machine name as part of 
the AHEM command line. The addi- 
tional headers and libraries are from 
the LAN Manager Programmer’s 
toolkit. 


AHEMSRV and WFW.BAS (Figure 2 
and Figure 3), written in Visual Basic 
2.0, create a mailslot and waits for 
messages to arrive. The blocking issue 
is solved by using a timer to check the 
mailslot regularly without a time-out. 
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Named Pipes 


A named pipe is a point-to-point chan- 
nel through which data may flow in 
either direction. Named pipes are cre- 
ated at one machine, referred to as the 
Server. A second machine, the Client, 
may open that named pipe. 


Name pipes must have a name of the 
form \PIPE\x. When referring to a 
particular named pipe on a given ma- 
chine, the syntax is \\MA- 
CHINE\PIPE\x 


But there is some bad news. Work- 
groups can only act as a named pipe 
client - it can use an existing named 
pipe created on a LAN Manager server 
or NT system, but cannot create named 
pipes itself. The blocking issues are 
addressed in the same way as for 
mailslots. 


As with mailslots, the named pipe API 
is available to both DOS and Windows 
applications through INT 21 and NE- 
TAPI.DLL respectively. Named pipes 
are integrated with the file system in 
Windows NT: this is not the case for 
Workgroups. 


W4WG API 
DDE and Network DDE 


Dynamic Data Exchange (DDE) has 
been around since Windows 2.0. It is 
a protocol based on the Windows mes- 
sage system. DDE hot-links two or 
more applications. One application 
acts as a data server and clients link to 
it, receiving new data whenever server 
data changes. DDE generally provides 
unidirectional data flow from server to 
client. 


Networked DDE is a Workgroups in- 
novation that extends DDE almost 
transparently across the LAN. Each 
workstation runs a gateway program, 
NETDDE.EXE, which converts be- 
tween DDF’s local protocol and a LAN 
session. A DDE topic can be made 
‘public’ at a server machine. This is a 
little like sharing a disk directory in File 
Manager: a public name is given which 
is used by other machines. A client 
wishing to connect to a remote DDE 
source specifies the remote server's 
name in the form  \\MA- 
CHINE\NDDES, along with the public 
topic name and the item name. 


The NetDDE API is packaged in an 
additional DLL, NDDEAPI.DLL, which 
provides a control interface for servers 
to create and manage shared topics. 
The Workgroups resource kit also con- 
tains the Network DDE Share Manager: 
a front-end tool for configuring Net- 
DDE shares. This information is cur- 
rently held in SYSTEM.INI but this may 
change in future. 


The server itself knows nothing of 
networked DDE: the dirty work is 
done by the transfer program. Only the 
client end would need to know the 
name of the workstation on which the 
program was running. 


The NetDDE API is not available to 
DOS applications. 


NetDDE Example 


The NETRES program (Figure 4) illus- 
trates the use of Networked DDE to 
monitor resource usage of a remote 
workstation. The Visual Basic program 
is a DDE source, continually monitor- 
ing the available system resources 
through the API call GetFreeSys- 
temResources(). The information 
is available through two DDE items, 
accessed as: 


@ NETRES|WinRes!GDI 
@ NETRES |WinRes!User 


Basic Programmer 
and Proud of it? 


You'll be glad to know that you're not alone. Basic Magazine 
is what every serious Basic user has been waiting for. Basic 
Magazine is written specifically for professional programmers 
using Basic by professional programmers. Every issue is 
packed with.... 

NEWS 

TECHNICAL FEATURES 

IN-DEPTH REVIEWS 

TECHNICAL TIPS 

BUG REPORTS 


Q&A 


Every issue brings reviews of the latest compilers and third 
party products, tips and tricks for quicker and better 
programming. 
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Basic Magazine is only available on subscription - £35 for 
one year, or £50 for two years - but .EXE readers can get a 
FREE sample copy by completing the form below and 
sending it to the FREEPOST address, or call us on 

081 994 6477, or fax on 081 995 7775 


Name: vob Title: 


Address: 


Postcode: 


Please return to Basic Magazine, FREEPOST, 10 Barley Mow Passage, London W4 4BR, 


{> cincte no. 911 J} 
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' ARE You Serious Apout C++? ! 


| __...THEN YOU SHOULD BE AT THE EUROPEAN 
C++ USER GROUP TECHNICAL CONFERENCE! 


If you want to achieve higher productivity, greater 
y. robustness, greater maintainability, and much higher 
sw 2 software reuse - you can’t afford to miss it. 
by AN The Conference offers the opportunity to 

\@\ hear and meet leading figures from the 
international C++ community. 

Presentations address current concerns 

and future developments and will also provide an 

Las| insight into some real-life C++ projects in a 
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The Technical Conference is being 
held on the 8th and 9th of July in Munich, with 
pre-conference tutorials on the 7th. 


Tel 


Return to: ECUG Conference, KBSL, 
1 Campus Road, Listerhills Science Park, I 
BRADFORD, W. Yorkshire, UK. BD7 1HR 

Telephone: +44 274 736895 


New Books from Microsoft Press 


WRITING 
SOLID CODE 


Microsoft's 
Techniques for 
Developing 
Bug-Free € 
Programs 


Written by a former Microsoft em ays 
developer and troubleshooter, Roel ny 
this book takes on the problem of 
software errors by examining the 
kinds of mistakes developers typically make. 


WRITING | 
SOLID 


COPt 


With the growing complexity of software today and the associated climb 
in bug rates, it’s becoming increasingly necessary for programmers to 
produce bug-free code much earlier in the development cycle, before the 
code is first sent to Testing. The key to writing bug-free code is to 
become more aware of how and why bugs come about. 


WRITING SOLID CODE provides practical approaches to the prevention and 
automatic detection of bugs. Throughout, Steve Maguire draws candidly 
on the history of application development at Microsoft for cases in point 
(both good and bad) and shows you how to use proven programming 
techniques to produce solid code. 

256 pages 1-55615-551-4 £21.95 


CODE 


CODE a 
COMPLETE = ttm 


COMPLETE 
A Practical 
Handbook of 
Software 
Construction 


Whatever your background - 
experienced developer, 
self-taught programmer, or 
programming student - this STEVE McCONNELL al 
ingeniously organized handbook 
contains state-of-the-art 
information that can help you write better programs in less time with 
fewer headaches, 


CODE COMPLETE is an encyclopedic treatment of software construction, 
the most important part of the software-development cycle. It contains 
some 500 examples of code (good and bad) and includes ready-to-use 
checklists to help you assess your architecture, design approach and 
module and routine quality. 


Perhaps most important of all, CODE COMPLETE provides a larger 
perspective on the software-development process and the role of 
construction in the process that will inform and stimulate your thinking 
about your own projects, enabling you to take strategic action rather 
than fight the same battles again and again. 


The concepts discussed in CODE COMPLETE are applicable to any 
procedural language in any computing environment. 
857 pages 1-55615-484-4 £29.95 


Available from all good bookshops. 
For a mail order service, or to request a catalogue, 
call 081 899 4036 


which give the GDI and USER free 
space percentages respectively. 


In order to make this information avail- 
able to NetDDE clients, The relevant 
part of the SYSTEM.INI should appear 
as in Figure 5. By convention, a shared 
topic name on the server is the actual 
topic name with an appending ‘$’ char- 
acter. 


As an example, if the program is run- 
ning on a workstation called FRED, a 
DDE client program running on a re- 
mote workstation can access this infor- 
mation as \\FRED\NDDE$|Win- 
Res$!GDI and \\FRED\NDDE$|- 
WinRes$ !User, eg as an Excel DDE 
formula. 


Generic Network Calls 


Even non-Workgroups versions of Win- 
dows have generic network support. 
A number of exported entry points in 
the USER module provide generic net- 
work support at a high level. Such 
facilities are required by standard Win- 
dows utilities such as Print Manager. 


As a documented example, consider 
WNetGetConnection, which tells 
the application whether a resource has 
been redirected to a remote machine, 
and if so, how. 


These routines are not extensively 
documented in the standard SDK, but 
are documented at the device driver 
level in the Device Driver Kit (DDK). 


Workgroups extends this API, adding 
support for reading the network con- 
figuration, automatic Workgroups lo- 
gon, password management and the 
like. 


NetBIOS 


NetBIOS (the Network Basic Input 
Output System) is a session-level API. 
Mailslots, named pipes, network DDE 
and the redirector use NetBIOS serv- 
ices. NetBIOS is one of the most com- 
mon network APIs for the PC, having 
been defined for the earliest IBM net- 


(DDEShares] 


WINRESS$=NETRES, WINRES, ,31,,0,,0,0,0 


Figure 5 - Configuring 
SYSTEM_INI for sharing the 
NetRes program 


34 .EXE Magazine, Vol 8, Issue 2, July 1993 


works in the mid 1980s, and sub- 
sequently adopted or emulated in 
many other systems. 


The NetBIOS API consists of submit- 
ting network control blocks (NCBs) 
through a DOS software interrupt or 
the NetBIOSCall1() Windows entry 
point. Non-blocking calls to NetBIOS 
are complex: NetBIOS can notify the 
caller that a non-blocking call has ter- 
minated using an interrupt-time call- 
back. In practice, any Windows 
application using callbacks must place 
them in a DLL, and the callback routine 
posts a Windows message. 


TCP/IP 


TCP/IP is not part of the standard 
Workgroups product. However, the 
Workgroups Resource Kit describes 
how to configure Microsoft’s TCP/IP 
(supplied with LAN Manager) into a 
Workgroups machine. A Workgroups- 
specific version of Microsoft TCP/IP is 
expected but no further details were 
available at the time of writing. 


TCP/IP itself defines no API, but vari- 
ous interfaces exist. The WinSock in- 
terface has been defined as a 
Windows-friendly interface to TCP/IP, 
based on the Berkeley UNIX ‘sockets’ 
library. The main differences between 
WinSock and the traditional BSD 
socket library are: 


@ WinSock sockets are not imple- 
mented as part of the file system; 
UNIX-style read and write calls can- 
not be used on sockets. 

@ WinSock provides automatic poll- 
ing and yield facilities to solve the 
blocking problem; BSD socket calls 
use UNIX scheduling services. 


A number of non-Microsoft implemen- 
tations of TCP/IP exist, and it is hoped 
that WinSock will become a standard 
interface for these too. 


NetWare 


Workgroups also has its own imple- 
mentation of the IPX/SPX protocol stack 
and ships with Novell’s NETX redirec- 
tor. NetWare API calls are available to 
DOS and Windows, through software 
interrupts and NETWARE.DLL. 


NetWare is not integrated into Work- 
groups as well as LAN Manager. This 
reflects to some extent the differing 
architectures and protocols, and also 
the political and commercial rivalries 
between Microsoft and Novell. 


W4WG API 


Conclusion 


Workgroups contains a rich LAN API 
with many standard interfaces and pro- 
tocols. Although restricted by a non- 
preémptive environment, it points to a 
future in which communications will 
play an important role in PC develop- 
ment. 
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Robert Seeman is a consultant and in- 
structor working for QA Training Lim- 
ited in Cirencester, where he specialises 
in Windows application development 
and client-server systems. He can be 
contacted on 0285 655888, or emailed 
as rseeman@qatrain.mhs.com- 
puserve.com. 


Thanks to Alex Shipp of QA for his help 
in preparing this article. 


References: Client/Server Program- 
ming with OS/2 2.0 (2nd Ed., Orfali 
and Harkey, Van Nostrand Reinhold), 
though not Windows-specific, is an ex- 
cellent overview of the PC’s communi- 
cation potential with lots of theory and 
practical code. 


The official’ Windows for Workgroups 
SDK contains documentation, header 
files, library files and so on. It is avail- 
able eg from CIX (in windows/files, 
WFWSDK.ZIP). If you want to develop 
Windows-only applications, this will be 
sufficient - the libraries are import li- 
braries covering the API. Ifyou want to 
build DOS applications, such as 
AHEM.C in this article, you will need 
to get a .LIB file which contains a stati- 
cally linked DOS version of the API. 
This is available in the LAN Manager 
Programmer's Toolkit. Alternatively, 
you can roll your own library from 
Ralph Brown’s Interrupt Listing which 
documents the INT 21 entry points from 
DOS (CIX again, exe/files IN- 
TER35A.ZIP et seq). 


LAN Manager Programmer’s Reference 
and LAN Manager, A Programmer's 
Guide (Microsoft Press) are a useful 
source of information on the LAN Man- 
ager API, The books are part of the LAN 
Manager Toolkit. 


The WinSock specification is available 
from Microsoft or from the CompuServe 
MSNETWORKS forum. 


Professional Tools for 
Professional Developers 


Windows 3.1 


MS-DOS 


Greenleaf CommLib 4.0 


CommLib 4.0 contains over 300 robust asynchronous 
communications functions including XMODEM, YMODEM, 
ZMODEM, Kermit and ASCII file transfer, XON/XOFE, 
RTS/CTS, and DTR/DSR handshaking, smart modem 
control, interrupt driven serial I/O for 13 drivers usin 
consistent “Level 2" API for all drivers. Supports DOS, 
Extended DOS, and Windows 3.1. 


Greenleaf PowerComm 

A native 32-bit Windows 3.1 implementation of Greenleaf 
CommLib 4.0. Extends CommLib’s capability using DLL and 
virtual device driver (VxD) to put time sensitive interrupt 
service and other routines at “Ring 0" for optimal throughput. 
Supports multiple Windows and/or DOS applications under 
Windows 3.1. Supports standard and most standard 
multi-port hardware including 16550 FIFO modes. (Requires 
Comm Lib 4.0) 


Greenleaf CommLib Professional 

New standard asynchronous: communications toolkit for 
Windows, DOS, and 286 Extended DOS. Includes Greenleaf 
CommLib 4.0 and PowerComm Toolkit for Windows. 


Greenleaf Comm++ 2.0 [XLAWAMSarileh! 


Comm++ class library includes numerous classes for asynch 
communications—from elemental hardware control classes 
to file transfer and terminal emulations (VT100, VT52, and 
ANSI). XMODEM, YMODEM, ZMODEM, Kermit, and 
ASCII file transfers. Many handshaking options. Supports 
numerous standard and intelligent multiport boards for DOS, 
Windows 3.x, and OS/2 2.0. 


Greenleaf ViewComm 

Lets you see data and status on the line + timestamps. 
Capture to buffer or file. Review using ASCII, hex, decimal, 
octal, or EBCDIC display. Extensive triggers: modem signal 
and string match criteria to start or stop capture. Source Mode 
lets you send from keyboard, file, or both. Configurable, 
push-to-DOS, many more features. 


Greenleaf Functions 

Over 370 functions including DOS interface, keyboard, 
mouse, color text, graphics, screen & video, string, time and 
date, polled-mode serial, interrupt services and Ctrl-Break, 
equipment interface, and extensive printer support. 


Greenleaf SuperFunctions 

SuperFunctions includes (over 370 functions) windows and 
basic menus (from DataWindows), Expanded ee 
support, extensive mouse and keyboard support, DO 
Critical Error Handler support, advanced DOS functions, an 
exhaustive set of time and date manipulation functions 
including poet scheduling support, ete. No overlap with 
Greenleaf Functions. 


Cc 
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32-Bit DOS 


Greenleaf Database Library NEW: HOT 


SoftC Database Library now published by Greenleaf Software. 
Reviewers rave about the speed and flexibility of this 
extensive “xBase” interface abr: Supports dBase III & IV, 
FoxBASE+, FoxPlus, dBXL, Alph. ‘our, Clipper, and 
Quicksilver, including their proprietary index and memo file 
systems. Rated fastest and most compatible ae e. 

‘omplete ISAM database toolkit. Highly portable ANSI C 
source Supper MS-DOS, Windows 3.1 (DLL included), 
portable to UNIX and OS/2. 


Greenleaf DataWindows 

DataWindows 3.0 with MakeForm data entry form generator, 
a true WHSIWYG designer to create resource files. Changes 
to forms do not require recompilation! 400 functions for 
logical windows, transaction oriented data entry, and menus. 
13 installable state-change functions including field and form 
validation. 


Greenleaf Financial MathLib 

A unique 19-digit “DECimal” number system avoids floating 
point errors. Over 195 functions include arithmetic, error 
proceosns, test, array math, transcendentals, percentages, 
/O, simple & compound interest, loan amortization, 
discounted cash flow, annuities, actuarial, and general 
business functions. Modeled on the HP-12C calculator. 


Greenleaf Financial MathLib++ 

MathLib++ is a C++ version of Financial MathLib described 
above. C++ iostreams are fully suported with overloaded I/O 
and math operators, so that programming is greatly 
simplified. One function call gets you a complete loan 
amortization table. Another computes the Internal Rate of 
Return of a set of discounted cash flows. 


All Greenleaf Products come with reference 
manual, online documentation system (with free engine), 
FREE unlimited telephone support, FREE BBS access, 
newsletter, extensive compilable examples for each function, 
NO Royalties, 60-day money-back guarantee, and are backed 
by the industry’s most experienced tech support staff. 
Cieenicar Gold Support (extra annual fee) pus upgrades on 
your desk as soon as they are released and gives U.S. 
customers toll-free access to tech support and BBS. 


@ Phone today for complete information, 
demo or details of how to order 
I 0566 86037 


‘GREENILEAF FAX 0566 86147 


s Citadel Software Ltd 


Coombe, Trewen, Launceston, 
Cornwall PL15 8QF 
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Mouse Handling 


A Mouse’s Tale 


Dave Mansell was so impressed when he first saw the Norton Utilities smooth mouse 
handling in text mode that, instead of buying the company, he wrote his own version. 


The first time I saw a ‘graphic arrow’ 
mouse cursor being used in text mode 
was in the famous Norton Utilities, 
V5.0. At first it looked as though Peter 
‘The Shirt’ Norton had achieved the 
impossible. Instead of the usual cell 
‘block’ character, jumping clumsily from 
one position to the next on the 80x25 
screen matrix, there was a proper ani- 
mated arrow shape, creeping around 
the display pixel-by-pixel. Not only 
does this look good, it also makes 
using the mouse noticeably easier. 


On reflection, I began to get an idea 
of how it could be done. At the time I 
was too busy to follow this idea up, 
but recently I needed to write some 
text user interface code and decided to 
have a go at producing a graphics 
cursor in text mode as part of the 
project. That code forms the basis of 
this article. 


There have been some published ex- 
amples of doing this in C and assem- 
bler, but I thought it would be fun to 
code as much as possible in C++, 
implementing a Mouse class to handle 
it. We will still have to resort to some 
assembler, but I have tried to keep it 
to an absolute minimum. 


This article will consist of two parts. In 
this first part, I present a class that 
encapsulates the functions of the 
standard Microsoft mouse driver. This 
will give us a base class. The ‘graphics’ 
cursor class will be derived from this 
in the second part of the article in the 
next issue. There are good reasons for 
this design. There are circumstances 
when we will want to abandon our 
‘graphics’ cursor in favour of a stand- 
ard text cursor. A notable example is a 
program running in a windowed DOS 
box under Microsoft Windows using a 
simulated text screen. A ‘graphics’ cur- 
sor created using these techniques 
does not display correctly. 


MS-DOS Mouse 


I'll begin with some background on 
using a mouse under text mode MS- 
DOS. Programming a mouse involves 
using the facilities provided by the 
Microsoft Mouse Driver. The functions 
offered by this driver have become a 
de facto standard and are supported by 
virtually all manufacturers of PC mice. 
The mouse driver is usually installed at 
system start-up, either in CONFIG.SYS 
(‘DEVICE=MOUSE.SYS’) or AUTO- 
EXEC.BAT. 


#ifndef _RECT_HPP 
#define _RECT_HPP 


class Rectangle 
{ 
public: 


// Prevent multiple inclusions 


typedef unsigned short ushort; 
typedef unsigned char uchar; 


Rectangle() { set(0,0,1,1); } 
Rectangle(ushort yl,ushort x1, 
ushort y2,ushort x2) 
{ set(y1,xl,y2,x2); } 
void set(ushort yl,ushort x1, 
ushort y2,ushort x2); 
virtual int is_inside(ushort row, ushort col); 


ushort height, width; 
ushort trow, brow, lcol, rcol; 
te 


#endif 


Figure 1 - RECT.HPP 
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An application program talks to the 
mouse driver via an 8086 software 
interrupt, int 0x33 (51 decimal), Using 
this interrupt, the application can ob- 
tain information about the position of 
the mouse cursor, the state of the 
mouse buttons (ie whether they are 
pressed) and can alter various parame- 
ters such as the mouse sensitivity. The 
interface is documented in many 
books, eg PC Interrupts (pub Addison- 
Wesley, ISBN 0-201-57797-6), and will 
not be detailed here. 


The first stage is to create a C++ class 
to handle the standard text and graph- 
ics mode hardware mouse cursors. 
This will support all of the functions 
available from the mouse driver, in- 
cluding the installation of a ‘callback 
function’. This is called by the mouse 
driver whenever a mouse event (such 
as mouse movement or a button press) 
occurs. 


In addition to the mouse classes, I have 
created a simple Rectangle class to 
describe a rectangle on the screen. The 
header for this, RECT.HPP, is shown in 
Figure 1 - the (straightforward) imple- 
mentation has been omitted to save 
space. Feel free to replace this class 
with your own equivalent if you have 
one, modifying the TMouse code as 
needed. 


TMouse 


The header file for our main class, 
TMOUSE.HPP, is shown in Figure 2. 
The class TMouse consists of a con- 
structor and destructor, together with 
a number of public functions and some 
protected functions and data variables. 
TMouse hides the mechanics of the 
mouse driver from our application, 
providing a clean interface. 


The link between TMouse and the 
mouse driver is the protected member 
function driver(). This encapsu- 
lates the int 0x33 call, using the 
mouse_regs variable to provide in- 
put data for the standard C function 
int86 (). All of the functions that talk 
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to the mouse driver use it, except for 
setgraphcursor(). This needs to 
pass the address of the cursor mask in 
segment registers, and so calls 
int86x() directly. 


Implementation 


As you can see, TMouse implements 
many of its member functions inline 
in the header file. The rest are imple- 
mented in TMOUSE.CPP (Figure 3). 


At the start of TMOUSE.CPP is a group 
of macros that simplify access to the 
BIOS data area at address 0x400. This 
area is used by the IBM PC BIOS to 
store data about the equipment con- 
figuration, including the current video 
mode, number of displayed columns 
and rows, and the point size of a 
character cell when the display is in a 
text mode. 


Following this we have the declaration 
a_installmouse(). This is actually 
an assembly language helper function, 
implemented in TMOUSE_A.ASM. It’s 
declared as a C function so that we 
don’t have to worry about things like 
calling conventions, name-mangling 


and this pointers. Its purpose is to 
store the address of a function to be 
called by an assembly language rou- 
tine tied to the mouse interrupt. More 
detail later. 


At first it looked 
as though Peter 
The Shirv’ 
Norton had 
achieved the 
impossible 


TMouse includes a number of public 
functions. I’ll go through these in detail 
so that you can use them in your 
programs. 


The constructor, TMouse:: 
TMouse (), ensures that there is only 
ever one instance of TMouse active at 
any time. It does this by asserting that 


#ifndef TMOUSE_HPP 
fidefine TMOUSE_HPP 


#include <d 
#include "r 
#include “cur! 


class TMouse 
{ 


public: 


‘TMouse (); 
virtual ~TMouse() 

{ CuxMouse = 0; driver(); } 
int isactive() { return ismouse; } 


int getstatus (unsigned *curposx, 
unsigned *curposy) 


void readcounters(int *countx, 
int *county); 


virtual void install_callback( 
void (cdecl *callback) 
(unsigned reason, unsigned state, 
unsigned curx, unsigned cury), 
unsigned short mask = 255); 


virtual void showcursor (void); 
virtual d hidecursor (void) ; 
virtual void hidecursor (Rectangle crect); 


void set (unsigned curposx, 
unsigned curposy) 
{ driver (4, 0, curposx*hpoints, 
curposy*vpoints/2); } 


void getpress(unsigned *count, 
unsigned *curposx, 
unsigned *curposy) 
{ pr_info(5, count, curposx, curposy); } 


void getrelease(unsigned *count, 
unsigned *curposx, 
unsigned *curposy) 


{ pr_info(6, count, curposx, curposy); } 


void setbounds (Rectangle srect); 


void setgraphshape(int hotspotx, 
int hotspoty, 
CursorMask &mask) ; 


void settextshape(int select, 
int start, 
int stop) 
{ driver(i0, select, start, stop); } 
void lightpen(int flag) 
{ (flag == 0) ? driver(14):driver(13); ) 


void setratio(unsigned ratiox, 
unsigned ratioy) 
{ driver(15, 0, ratiox, ratioy); } 


void setthreshhold(unsigned threshhold) 
{ driver(19, 0, 0, threshhold); } 


static TMouse *getmouse (void) 
{ return CurMouse; } 


protected: 
union REGS mouse_regs; 
unsigned short isi : 
unsigned short 
unsigned short mrows, mcols, 
hpoints, vpoints; 


int isgraphics (void); 


void driver (int val_ax 
int val_bx 
int val_cx 
int val_dx 


void pr_info(int func, unsigned *count, 
unsigned *cpx, unsigned *cpy); 


static TMouse *CurMouse; 
Me 


void far mouse_isr (void); 


#endif 


Figure 2 - TMOUSE.HPP 
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the static data member CurMouse 
must be 0 before any class initialisa- 
tion. A static data member, you'll re- 
call, has the property that there is only 
ever one instance of it shared between 
all instances of class. This is initialised 
at the start of TMOUSE.CPP to ‘0’, and 
set to the address of the TMouse in- 
stance in the constructor. An attempt 
to create a second instance of a 
TMouse causes the assert to trip, since 
CurMouse is not 0. 


After setting up CurMouse, the con- 
structor determines whether the dis- 
play is in text or graphics mode (by 
calling isgraphics ()), and sets de- 
fault row, column and point variables 
accordingly. The protected function 
isgraphics() works by pulling the 
current video mode number out of the 
BIOS data area and comparing it with 
a list of known text modes. 


TMouse::driver(), briefly men- 
tioned above, is a protected function 
used to simplify access to the mouse 
through interrupt 0x33. It sets up the 
registers required by the relevant sub- 
function, then calls int 86 () to do the 
business. If you would rather be quick 
than portable, you can optimise this 
function through the use, eg, of 
pseudo-registers and geninter- 
rupt(). 


If you look in TMOUSE.HPP, you will 
see that the last three parameters have 
default values of 0. This means you can 
call the function with values for only 
those registers needed for the sub- 
function you want. 


The public function TMouse: :get- 
status () uses sub-function 3 of the 
int 0x33 mouse interface to obtain the 
current mouse status. This information 
includes the current cursor position 
and the position of the mouse buttons. 
This last bit of data is stored as a bit 
pattern in a single byte. One bit is 
assigned to each mouse button; a ‘1’ 
indicates that the button is down. 


TMouse::readcounters() reads 
the mouse motion counters. These in- 
dicate how far the mouse has moved, 
in ‘mickeys’ (1/200ths of an inch), 
since the last call to this function. It 
takes two pointers to integers as argu- 
ments, in which are stored the motion 
counts in the x and y directions. 


TMouse: : showcursor () and 
TMouse::hidecursor() show/ 
hide the mouse cursor. You should 
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always hide the mouse cursor during 
any screen update so that you do not 
leave ‘mouse tracks’ on the display. 
These are implemented so that they 
can be nested. Each call to hidecur- 
sor() should have a corresponding 
call to showcursor (). The cursor is 
only displayed when all the nested 
pairs have been exited. The private 
variable ishidden is a counter used 
to control whether the cursor is dis- 
played or hidden it works like a count 
on a semaphore. 


There is a second version of 
TMouse: :hidecursor () that takes 
a Rectangle as an argument. This 
uses a sub function of the mouse driver 
to hide the mouse cursor when it 
moves into a selected rectangle on the 
screen. This works independently of 
the standard showcursor() and 
hidecursor() functions. It can be 
used when updating a window. 


| sincase <stdlib.h> 
#include <dos.h> 
#include <assert.h> 
#include "tmouse.hpp" 


define BIOS_POINTS \ 
*((unsigned char far * 
define BIOS_COLS \ 
*((unsigned char far * 
fidefine BIOS_ROWS \ 
*((unsigned char far * 
fidefine BIOS_MODE \ 
*((unsigned char far * 


0x00400085L) 


0x0040004AL) 


0x00400084L) 


0x00400049L) 


// This function is in TMOUSE_A.ASM. 
// Tt is declared as a C function 
// so that we can forget name mangling. 
extern "Cc" ( 
void _cdecl a_installmouse( 
unsigned short, 
void (_cdecl *) (unsigned, unsigned, 
unsigned, unsigned), 
void *); 


) 


// used by TMouse: :isgraphics 

const int NumTextModes = 

static int TextModes(NumTextModes} = 
CO Be SAMS Ve 


// initialize static member 
TMouse *TMouse::CurMouse = NULL; 


‘TMouse: : TMouse () 


// Only one mouse allowed 


assert (CurMouse == NULL); 
CurMouse = this; 
ishidden = 1; 


long far *fp = (long far *) 0x000000ccL; 


// Some versions of DOS have 0 in the 
// vector table for int33 
mouse_regs.x.ax = 0; 

if (*fp t= OL) 

( 


ismouse = 1; 
driver (0); 
} 
ismouse = (mouse_regs.x.ax != 0); 


if (isgraphics()) ( 

mrows = 200; 

mcols = 640; 

hpoints = vpoints = 1; 

if (BIOS_ROWS != 0) { 
mrows = BIOS_ROWS + 1; 
mcols = BIOS_COLS; 

) 

else { 

mrows 

meols 


bees 


24; 
80; 


wou 


TMouse::set() moves the mouse 
cursor to a particular position on the 
display. For instance, you might use 
set (20,10) to position the mouse at 
column 20, row 10 on the screen. This 
function uses int 33h sub-function 4 to 
set the position and is implemented as 
an inline call. 


TMouse: :getpress () and 
TMouse::getrelease() get infor- 
mation about button presses and re- 
leases from the mouse driver. Both 
these functions take three pointers as 
arguments. The first points to an un- 
signed integer that holds the number 
of the button you are asking about. 
When the function returns, this pa- 
rameter holds the number of 
presses/releases since the last time it 
was called. The other pointers refer to 
variables which contain the mouse po- 
sition at last press or release. If you 
look at the source, you will see that 


hpoints = vpoints = 8; 

if (BIOS_ROWS != 0) { 
mrows = BIOS_ROWS + 1; 
mcols = BIOS_COLS; 
vpoints = BIOS_POINTS; 


} 
HM 


int TMouse: :isgraphics() 
it 
int mode = BIOS_MODE 


for (int i = 0; i < NumTextModes; i++) 
if (TextModes[i} == mode) 
return 0; 
return 1; 
} 


void TMouse::driver(int val_ax, int 
val_bx, 
int val_cx, int val_dx) 
{ 
if (ismouse) 


{ 


mouse_regs.x.ax = val_ax; 
mouse_regs.x.bx = val_bx; 
mouse_regs.x.cx = val_cx; 
mouse_regs.x.dx = val_dx; 


int86(0x33, &mouse_regs, &mouse_regs) ; 
} 
} 


int TMouse: :getstatus (unsigned *curposx, 
unsigned *curposy) 


{ 


driver (3); 
*curposx = (mouse_regs.x.cx)/hpoints; 
*curposy = (mouse_regs.x.dx)/vpoints; 


return mouse_regs.x.bx? 


} 


void TMouse::pr_info(int func, 
unsigned *count, 
unsigned *curposx, 
unsigned *curposy) 


driver(func, *count) ; 
*count = mouse_regs.x.bx; 
*curposx = (mouse_regs.x.cx) /hpoints; 
*curposy = (mouse_regs.x.dx) /vpoints; 
) 


void TMouse: : showcursor (void) 


{ 
if (ishidden) 
{ 
ishidden--; 
if (ishidden == 0) 
driver(1); 
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Figure 3 - TMOUSE.CPP 
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both getpress() and getre- 
lease () use a private internal helper 
function, getpr (), to avoid duplicat- 
ing code. 


TMouse::setbounds() restricts 
the mouse cursor to the specified area. 
Most often this is used to prevent the 
mouse cursor from moving outside the 
displayed screen area. For ease of use, 
this function takes a Rectang1le as its 
argument. 


Cursor shapes 


TMouse: :settextshape () de- 
fines a mask for the cursor for text 
mode. Normally you can only define a 
cursor that uses an existing display 
character from the hardware character 
set with a complementary attribute 
(known as an attribute cursor), or 
block or line cursors of various thick- 
nesses (known as a hardware text cur- 


void TMouse: :hidecursor (void) 
{ 
if (ishidden == 0) 
driver (2); 
ishidden++; 
d 


void TMouse: :setgraphshape (int hotspotx, 
int hotspoty, 
CursorMask 
&mask) 
( 
struct SREGS sregs; 


if (ismouse) 

( 
mouse_regs.x. = hotspotx; 
mouse_regs = hotspoty; 
sregs.es = FP_SEG(mask.screenmask) ; 
sregs.ds = FP_SEG(mask.screenmask) ; 
mouse_regs.x.dx = 

FP_OFF (mask. screenmask) ; 
int@6x (0x33, &mouse_regs, 
&mouse_regs, &sregs); 


) 
) 


void TMouse: :readcounters (int *countx, 
int *county) 
{ 
driver (11); 
*countx = mouse_regs.x.cx; 
*county = mouse_regs.x.dx; 


void TMouse: :setbounds (Rectangle srect) 
{ 
driver(7, 0, srect.lcol*hpoints, 
srect.rcol*hpoints) ; 
driver (8, 0, srect.trow*vpoints, 
srect.brow*vpoints) ; 


} 


void TMouse: :hidecursor (Rectangle crect) 
{ 
mouse_regs.x.si = crect.lcol*hpoints; 
mouse_regs.x.di = crect.trow*vpoints; 
driver(16, 0, crect.rcol*hpoints, 
crect.brow*vpoints) ; 


} 
// a_installmouse is in tmouse_a.asm 


void TMouse: : instal1_callback 
(void (cdecl *func) (unsigned reason 
unsigned state, 
unsigned curx, 
unsigned cury), 
unsigned short mask 


static unsigned char stack(260]; 


a_installmouse(mask, func, stack+260); 


} 
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sor). The first argument selects the 
cursor mode. A value of 1 indicates 
that the following arguments specify 
the start and end scan lines within a 
character block. A value of 0 means 
that the following arguments specify 
the character to use for the screen 
mask and cursor mask respectively of 
the attribute cursor. These specify the 
character to use, and how to merge its 
attribute with the underlying screen 
attribute. 


TMouse::setgraphshape() de- 
fines a mask for the cursor to use in 
graphics mode. The default cursor is 
an arrow pointing upwards and tilted 
45 degrees to the left. This function 
allows you to change the appearance 
of the graphics cursor. You could, for 
instance, change it so that it looks like 
an hourglass. The parameters hotx 
and hoty indicate where the ‘hot spot’ 
of the cursor is. The position of this 
point on the display indicates the po- 
sition of the cursor. 


The mask parameter takes a Cursor- 
Mask, defined in CURSORS.HPP (not 
listed here - will be included next 
month). This consists of two integer 
arrays that define the shape of the 
cursor in 1s and Os. The first array 
defines those parts of the cursor that 
are to be transparent, ie will allow the 
underlying display to show through; 
the second defines the actual shape of 
the cursor. 


Now an obscure mouse function, which 
is included only for the sake of com- 
pleteness. TMouse: : lightpen() en- 
ables or disables mouse emulatation of 
a light pen. A non-zero argument turns 
the emulation on, and a zero argument 
turns it off. The pen is ‘off the screen’ 
when the left and right buttons are up, 


Bit Event 

0 Call if mouse moves 

1 Call if the left button is pressed 

2 Call if the left button is released 

3 Call if the right button is pressed 

4 Call if the right button is released 

{5} Call if the middle button is pressed* 
6 Call if the middle button is released* 
*Obviously, bits 5 and 6 apply only to 

three button mice. 


Figure 4 - Mapping mouse 
events to mask bits 
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and on the screen when both buttons 
are down. I’ve never seen this used in 
a real application. 


TMouse::setratio() changes the 
sensitivity of the mouse. It does this by 
altering the mickey/pixel ratio. The 
lower the value of this ratio, the more 
the cursor will move for the same size 
movement of the mouse. 


Although it’s 
included for 
completeness, 
I've never seen 
the obscure 
lightpen mouse 
Junction used in 
areal 
application 


In a similar vein, TMouse::set- 
threshold() sets the speed at 
which the mickey/pixel value tempo- 
rarily halves so that the mouse cursor 
moves faster. This allows the mouse 
cursor to move quickly around a large 
display without losing sensitivity when 
manipulating small areas of the dis- 
play. Speed is calculated in mick- 
eys/second. 


The penultimate function is 
TMouse: :install_callback(). 
This gives the user of class TMouse 
access to a powerful feature of the 
mouse driver: the ability to install his 
own interrupt handler that is called 
whenever a mouse interrupt occurs. 
This can be when any interrupt occurs, 
or only when it is triggered by a par- 
ticular mouse action, such as a button 
press. 


Rather than just pass the address of the 
callback function straight to the mouse 
driver, class TMouse installs its own 
handler (written in assembly lan- 
guage) and then uses this to call the 
user’s callback. Doing things this way 
seems to add further complication and, 
as I dropped down into assembler for 
speed, may appear contradictory. 


Mouse Handling 


However, it has one big benefit: it 
allows us to set up a local stack for the 
callback, eliminating the chance of fail- 
ure due to an overloaded program 
stack. 


The mask argument determines for 
which mouse events the handler gets 
called. The various types of events are 
mapped to bits, as shown in Figure 4. 


The final public function in class 
TMouse is a static function, get- 
mouse (). Remember that you can call 
a static function even without an in- 
stance of the class. The benefit of 
providing one here is that it avoids the 
need to pass pointers to a TMouse 
object to any function that needs the 
mouse. The function can simply use 


TMouse *mouse = TMouse::getmouse; 


If there is no TMouse object in exist- 
ence it will return NULL, allowing a 
mouse object to be created on de- 
mand, 


End of Part 1 


Ihave now built a class that will enable 
you to add mouse support to your C++ 
programs. If you send off for the soft- 
ware, you will also find a simple test 
program for the class, TEST.CPP, 
which displays a mouse cursor and 
prints information on the cursor posi- 
tion and status to the screen. 


In the second half of this article, I will 
get to the ‘sexy’ bit: I will inherit a new 
class from TMouse that will give us a 
pixel addressed arrow cursor in text 
mode. 


Dave Mansell is the Managing Director 
of Citadel Software Limited, a company 
that develops and markets C and C++ 
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Visual C++, 
The Small Print 


Francis Glassborow takes a break from his CUG column to deliver 
the final low-down on Visual C++. 


The obvious question for a reviewer of 
a product the size of Microsoft’s Visual 
C++ is where to start. After much 
thought, I have come to the conclusion 
that I can do no better than a walk 
through highlighting the strengths and 
weaknesses that I have found during 
the last few months. 


When I collected my pre-release (late 
beta) version from Microsoft it was just 
as well that my rucksack was large and 
empty and that I was in the best of 
health: the product was weighty. The 
release version is even heavier, with 
well over 6000 pages in ten manuals, 
together with a 290 page comprehen- 


sive index. Actually I was to learn later | 


that even such a substantial index was 
not going to point me in all the right 
directions. 


The release version comes on twenty 
3.5" high density disks (a CD ROM 
version with everything including docu- 
mentation is also available). When I 
installed these, I avoided the mistake I 
had made with the pre-release version 
by ensuring that I had a large number 
of buffers specified in my CONFIG.SYS 
file, and that I had disk caching en- 
abled. Even so, installation took well 
over an hour. Like many, I first 
xCOPYed all the disks to my hard- 
drive (a large SCSI 1 GB 12ms drive 
with plenty of space). One pleasant 
surprise was to find that the set-up 
program handled the resultant 20 sub- 
directories (one per floppy disk) auto- 
matically. However this does not justify 
the time taken getting the material onto 
the hard-disk. The blame must lie with 
Microsoft which, for some reason, still 
does not archive its files. 


First Sight 


The first thing you will notice is that 
the old PWB has gone and been re- 
placed by a glossy new IDE called 
Visual Workbench. Very soon you will 
come to realise that hiding among a 
number of real enhancements are 
some genuine frustrations. Why has 
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MS provided an editor of such poor 
functionality that it would be hard put 
to find a place in the public domain 
arena? I am accustomed to editors that 
provide me a range of functionality 
including macros and folding. What I 
would like is an advanced syntax 
checking editor. Some compilers can 
be used to check syntax but those with 
previous experience of MS develop- 
ment tools will (rightly) suspect that 
the MSVC++ compiler is likely to be a 
court of last resort (ie take a little more 
time than usual to get all the semico- 
lons in the right places). 


Actually, in Microsoft’s defence, they 


do provide a facility for adding your 
own editor to Visual Workbench. The 
problem is that you still have to go 
back to their offering when debugging, 
so this is not the answer. 


All I can say about the Visual Work- 
bench is that it provides a lot of desir- 
able functionality, but you do need to 
spend a good deal of time exploring it 
because not everything is where you 
expect to find it. At least we do not 
have to fight nested menus that roll up 
at the drop of a feather. Most of your 
choices are made via nested dialog 
boxes (Borland, please note). 


The Compiler 


MSVC++ is far more tightly bound to 
the underlying operating system and 
Windows than earlier versions of MS C 
(and C++) compilers. MSVC++ is a 
package for developing products for 
Windows (later versions will aim at 
development for Windows’ succes- 
sors). In the battle between Windows 
NT and OS/2, this is a package that 
battles on the side of NT and its deriva- 
tives. If you have any thoughts about 
developing for OS/2, using this prod- 
uct will make moves in this direction 
(much) harder. 


C++ enthusiasts should note that, like 
MSC\C++ 7, MSVC++ only supports 
the AT&T 2.1 version of Cfront. C++ 
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has moved on some way since then 
and many exciting things like tem- 
plates are in common use among C++ 
aficionados. The only advanced fea- 
ture (beyond 2.1) that Microsoft adds 
is its version of exception handling (via 
preprocessor macros). Unfortunately, 
though there is still a lot of debate 
about this topic, the one method that 
the ANSI\ISO joint committee on C++ 
standardisation has decided not to use 
is that implemented by Microsoft. 


If you are serious about learning ad- 
vanced C++ techniques you should 
know that this compiler will not sup- 
port much of the material that is being 
published by the ‘experts’. Many fea- 
tures in MSVC++ are implemented via 
pre-processor macros; the current 
thinking in the C++ community is to 
eliminate the pre-processor. 


A question that is bound to occur to 
many is whether this is MSC\C++ 8, If 
you watch the compiler messages 
carefully you will discover that the 
compiler thinks that it is. From what I 
can see, such a claim is rather overstat- 
ing the issue in so far as changes to the 
compiler are concerned. It is more like 
a .2 or .3 upgrade - enough extras to 
introduce some new bugs and irritants 
(like issuing a warning message when 
encountering a correctly used I/O ma- 
nipulator taking a parameter). Mi- 
crosoft’s decision to give the product 
a new name and start renumbering the 
releases from 1.0 is sensible, because 
nearly all the extra quality in this pack- 
age is found in the supporting tools - 
more of these anon. 


If you buy the professional version of 
MSVC++, you get full MS-DOS support 
including compiling a .EXE, .COM, p- 
code application and overlaying. I can 
say very little about these because they 
all seem to work as expected and I do 
not have an application large enough 
to test the overlay facility. I suspect that 
most programmers will choose to stick 
with whatever tried and tested overlay 
support they currently have. 
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There is one eccentricity. The standard 
version offers no support for produc- 
ing MS-DOS executables. With the de- 
mise of the Quick compilers, that 
means that there is no cheap entry 
point to DOS programming for those 
who wish (or whose programs re- 
quire) the power of C/C++. When I 
tackled a Microsoft rep on this issue, 
he opined that, as all new users had 
Windows, they would naturally want 
to write programs for Windows. I think 
this is a serious blind spot. Many ama- 
teurs want the power of a language 
such as C because they are doing work 
in such areas as number theory, where 
the performance hit for using Win- 
dows is quite unacceptable. 


In addition many professional pro- 
grammers working in support areas, 
developing small utilities or providing 
extra functionality to a DOS applica- 
tion (databases spring to mind) have 
no use for Windows programming. 
Perhaps this omission says something 
about Microsoft's view of the World 
and the objectives its development 
tools are intended to support. 


At least both versions of the package 
supports QuickWin style program- 
ming, so if you just want a quick-and- 
dirty program to do something, and do 
not mind it running in a Window, the 
tools are there. 


Now I will leave these issues aside, 
because MSVC++ is not about writing 
programs in C or even in C++, it is 
about writing packages for Windows. 


A Simple Windows App 


Those of you who have used the Mi- 
crosoft Foundation Classes found in 
MSC/C++ 7 will be delighted to see the 
new enhanced MFC 2.0. This is a mas- 
sively improved version of MFC and 
lies at the heart of MSVC++. There are 
still rough edges, so we can expect 
MFC 2.1 to arrive at some time. With 
MFC 2.0, Microsoft has provided the 
basics for two major tools. 


The first of these is the AppWizard 
which is used to build the framework 
for your new application. This is well 
named because it gives you a really 
magical start. No longer do you have 
to spend precious hours (more likely 
days or weeks) of development time 
getting such things as a toolbar, or 
printer functionality into your pro- 
gram. A few well documented steps 


and the AppWizard creates the multi- 
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tude of files that are needed for your 
framework. Make any simple changes 
you want (none to start with, but as 
you gain experience you will have a 
few things that you want to tweak 
straight away) and you are ready to 
develop your own product. 


Serious C++ 
users should 
know that this 
compiler will 
not support a 
lot of the 
material 
published by 
the ‘experts’ 


Before you try to compile this frame- 
work, switch off all the extras you can 
locate - optimisers, debug code gen- 
eration, browsers etc. Alternatively you 
could arrange a comfortable coffee 
break, because even on a relatively fast 
machine with reasonable disk perform- 
ance and plenty of spare space (in- 
cluding 16 MB of RAM) a full build of 
an executable with debug code and 
full optimisation is time consuming 
(nearly four minutes on my 486/33 for 
an empty framework). It is actually 
much quicker to construct an empty 
but fully functional framework than it 
is to build an executable from it. 
Clearly this is not a product for a 
low-end 386SX machine. 


Using AppStudio 


It is very unlikely that the framework 
that you have produced will include 
all the resources that you need, so you 
will want to edit your resources file. 
AppStudio is the tool provided to add 
resources. You do not need to bounce 
back and forth between Editor and 
AppStudio via program manager, there 
is an option in the Options:Editor dia- 
log that allows you to specify that 
AppStudio is to be used to open .RC 
(resource) files. 


ClassWizard 


This is not the place to go into details 
about writing Windows applications. 
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Suffice to say that your program must 
handle its interaction with Windows 
via reactions to a range of messages. 
Experienced Windows programmers 
know that the whole process of creat- 
ing and maintaining message handling 
functions is one that fills them with a 
longing to find another way of earning 
their living. 


Much of the work is repetitive and 
hardly needs the intelligence associ- 
ated with good programming. The 
very fact that it is repetitive invites the 
use of a computer to do it. Essentially 
this is what the ClassWizard does. The 
programmer provides the intelligence 
and ClassWizard provides the underly- 
ing common code (documented) to- 
gether with comments indicating spots 
that need human action. It is not per- 
fect and it will take you a little time to 
explore all the facilities but it will be 
time well spent. 


Now that much of the burden of Win- 
dows application programming has 
been semi-automated your skills are 
released to tackle the functionality that 
your application will provide. 


Other Tools 


The debug support is improved. The 
ability to single-step, step into a func- 
tion, out of it and over it with a single 
click on the tool bar adds to your 
feeling of control. The ability to view 
the call stack can be useful. 


There is a good quality code browser. 
it is well worth the time and effort that 
it takes to learn to use it. 


MSVC++ as a Whole 


By now you may have some ideas 
about how I feel about this product but 
it is time for me to dot the i’s and cross 
the t’s. 


MSVC++ is clearly a set of tools for 
writing Windows applications. In or- 
der to write such applications you 
need a compiler and one has been 
included. It comes from a long heritage 
of MS compilers and shows evidence 
that Microsoft is learning from experi- 
ence. It is still relatively slow, though 
it does provide a substantial range of 
optimisations. These include a first 
shot at supporting smart-linking. 


Smart-linking is a method by which 
functions that have not been used in 
an application are not included in the 
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executable. The premier exponents of 
this in the PC world are Clarion Top- 
Speed. In C, Pascal and other earlier 
languages smart-linking is a pleasant 
luxury as it allows you to use modules 
of source code as libraries. In C++, 
with its vast assemblages of over- 
loaded functions, smart-linking is an 
important tool for generating compact 
efficient code. 


The facility provided in this package is 
only a first cut at the problem. Mi- 
crosoft have quite a way to go before 
this aspect of their tools fulfils its prom- 
ise and becomes effectively transpar- 
ent to the programmer. 


As a C++ programmer with strong 
leaning towards object-orientation I 
am sorry to see that the compiler sup- 
ports no more of C++ than MSC\C++ 
7. I was staggered to find no less than 
21 extra keywords (albeit correctly im- 
plemented with a leading double-un- 
derscore), 17 in the joint C/C++ list but 
without support for the new keywords 
introduced in June 1991. The implica- 
tion is that this is intended as a com- 
piler for compiling Windows apps. As 
such I believe it does a good job, but 


I have reservations about its suitability 
for other C++ programming tasks. 


The combination of Compiler, Linker 
and debug support is an improvement 
on MSC/C++ 7 but not enough to merit 
a move from some other set of devel- 
opment tools. 


The strengths of this product lie in the 
new tools: AppWizard, ClassWizard and 
AppStudio. When these are coupled 
with the much improved Microsoft 
Foundation Classes I must say that 
those developing applications solely 
for Windows need some very powerful 
reasons for not switching to MSVC++. 


A major reason for staying with some 
other development package would be 
the desire to develop applications for 
other platforms. It is both the major 
strength and the major weakness of 
this product that it concerns itself with 
the needs of the Microsoft Windows 
application developer. 


Benchmarks 


The Editor was very keen that I pro- 
vide some benchmark results. Unfor- 
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tunately its main strengths cannot be 
assessed in these terms. 


The complexity of modern compilers 
is such that actually getting optimal 
results from one is an art based on 
considerable experience (see the 
Dhrystone example). Every compiler 
producer can find benchmarks com- 
bined with compiler switches that 
make their product look good. 


I took the batch of benchmark pro- 
grams provided by .£XEand sent them 
to the UK product managers of 
MSVC++ and Borland C++ with the 
request that they return project files for 
each of the products that would pro- 
vide the best results for their product. 
Both agreed that this was both a fair 
and sensible way to tackle the prob- 
lem. Both companies sent me their 
‘white papers’ on benchmarking. After 
more than four weeks neither com- 
pany has managed to supply the pro- 
ject files. Instead, I have fallen back on 
using the default production optimisa- 
tion switches. 


What follows is a commentary on my 
results when compiling and running 
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the various programs. They should 
give you some feel for differences be- 
tween the two products. In fairness I 
think you should remember that Bor- 
land C++ 3.1 is almost a year older than 
MSVC++ 1.0. 


You should also note that none of the 
programs was designed to exercise 
specific strengths and weaknesses of 
compilers. For example: no tests of the 
advantages of smart linking and of 
p-coding have been provided. On the 
other hand, programs that required 
facilities that are specific to the Borland 
product (or facilities not generally 
available, eg exceptions) have been 
omitted. A good example would be a 
C++ technique called ‘smart pointers’ 
that needs templates for an efficient 
implementation. 


In the following both compilers were 
used to produce release versions of the 
executables for 386 machines. I ran 
both compilers from Windows with no 
other applications running at the same 
time. 


Array. This is a simple program that 
creates a large array of longs, initialises 


it with a simple random number gen- 
erator and then uses qsort () to sort 
it. This process is repeated 1000 times. 
MSVC++ took 21 secs to compile and 
link an executable of 12535 bytes of 
code that ran in 20 secs. BC++ com- 
piled and linked in 8 secs producing 
an executable of 13580 bytes that ran 
in 16.5 secs. Recompiling for minimum 
size did little to affect any of the above 
figures. 


Bisect. This is a little program whose 
source code is designed to give C 
programmers apoplexy; it contains 
five goto commands in 85 lines of 
code. It also lacks any form of docu- 
mentation. If I understand correctly it 
is intended to check the accuracy of 
the floating point emulator. 


MSVC++ took 22 secs to produce a 
23318 byte executable compared with 
BC++’s 8 secs to produce a 23006 byte 
one. Both programs produced identi- 
cal results (1.324718 compared with 
the programmer’s claimed true result 
of 1.324707). 


One interesting point is that MSVC++ 
managed to identify several lines of 
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code that were unreachable. (Some 
test code that was conditionally exe- 
cuted if a debug variable was initial- 
ised as true. Yes, it was that sort of 
code.) 


GNU awk for MS-DOS. This is a multi- 
file project that I used to test the com- 
pile and link speed (compilers set to 
produce minimum code size). I could 
not fairly benchmark the resulting ex- 
ecutables because I had to do some 
rapid patches to get it to compile with 
MSVC++ and I cannot be certain that 
these did not alter some aspect of the 
product’s functionality. 


BC++ took 2 mins 58 secs to produce 
a 128972 byte executable from 108213 
lines of source code. MSVC++ took 10 
mins 45 secs to produce a 128649 byte 
executable from the same source code 
files. 


GNU Chess for Windows. I used this 
to test MSVC++ compiling and linking 
with a make file for MSC\C++ 7. This 
is important if the package is to be 
used with existing products. It failed 
this test, generating two linker errors. 
Do not take this as a severe criticism, 
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source code execute at run time- even 
Single Step through execution. 

CA-dBFast 2.0 also includes CA-RET — 
an outstanding Windows-based report 
writer that lets you mix text, graphics 
and data on the same report ina full 
WYSIWYG environment. 

Creating great-looking tabular reports, 
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aword processor. 
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wake up old applications or build 
brilliant new ones, there's only one 
way to marry Windows beauty and 
Xbase power. 

Check out CA-dBFast today. 


Qomrures 
TSSOCIATES 


Software superior by dlsign. 


New CA-dBFast Release 2.0. 


©CA Computer Associates Ltd., Computer Associates House, 183/187 Bath Road, Slough, Berks., SL14AA. 
All product names referenced herein are trademarks of their respective companies. 
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but more as a warning that you may 
need to edit such files if you replace 
MSC\C++ with MSVC++. 


Data Encryption Standard. This is a 
program that implements the DES in 
software. It is computationally inten- 
sive for integer arithmetic and I used it 
as a measure of MSVC++’s to optimise 
such code for speed. 


MSVC++ produced an executable of 
15535 bytes compared with BC++ 
which produced one of 19996 bytes. 
On testing these on a reasonably large 
file, the MSVC++ version was also sig- 
nificantly faster, 66 secs versus 77 secs. 


Dhrystone. Now here we have an 
interesting set of results because this 
program is often used as a hardware 
benchmark. The results I obtained 
raise serious questions about using it 
to compare machines unless they can 
run the same executable. 


BC++ took 13 secs to produce a 10488 
byte executable that ran in 24 secs 
(=20833 dhrystones). MSVC++ took 27 
secs to generate a 9569 byte executable 
that ran in 19 secs (=26315 dhrystones). 


I then noticed that the archive pro- 
vided by .EXE included a 9466 byte 
executable produced by Microsoft us- 
ing MSC\C++ 7. When I ran this I could 
hardly believe my eyes. It took 13 secs 
(=38461 dhrystones). There was also a 
make file provided, so I tried recom- 
piling using MSVC++’s external make 
file facility. The result was different 
again, 9514 bytes running in 14 secs 
(=35714 dhrystones). 


Nothing could have better confirmed 
my belief that benchmarking tells you 
more about the skills of the program- 
mer than it does about compilers and 
hardware. Obviously the secret lies in 
the switch settings, but the hand tai- 
lored switches produced a smaller 
product that ran 50% faster than that 
produced by relying on the producers 
switch settings for fastest executable. 


Conclusion 


MSVC++ is a product that Microsoft 
can be justifiably proud of. There is still 
room for improvement, but I have no 
doubt that another one will be along 
next year. For those that it is aimed at 
(Microsoft Windows Application De- 


Visual C++ 


velopers) it is clearly ahead of the 
competition. The rest will either have 
to learn to program for Windows or 
use another compiler. 


For those concerned with multi-plat- 
form development, MSVC++ produces 
fast compact code... slowly. It is not 
capable of using the newer C++ librar- 
ies that are based on the recent devel- 
opments in the language except via 
ugly, error-prone work-arounds. 


Francis Glassborow is the driving force 
behind CUG(UK), and Editor of its 
house journalC Vu. For more informa- 
tion on this august organisation, please 
contact him on 0865 246490, or email 
JSrancis@robinton.demon.co.uk. 


Microsoft Visual C++ has an RRP of 
£335 for the Professional Edition on 
CD-ROM or diskette, or £279 for a ‘tree 
saver’ version without printed docu- 
mentation. The Standard Edition costs 
£139. Upgrade information is on 081 
8938000. 
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MagnaCharter II 


SAVE HOURS 
produce 
flowcharts in 
minutes 


Windows 
Compatible 


Quick to. 
learn 


Includes BS4058/ 
q |SO5087 standard 
symbols 


Flexible text positioning 


Database 
schemas 


Spreadsheet Professional 
Style Quality Output 


Flowcharting - ) 
with ease 


MagnaCharter ll relieves 
the pain of drawing charts 


MagnaCharter ll is the latest version of this much 
acclaimed product - for Microsoft Windows. 


+ Based on the spreadsheet principle. 

+ Builds charts in minutes - not hours. 

* Includes standard flowcharting symbols. 

+ Use "crowsfeet" for database diagrams. 
MagnaCharter II divides the screen into cells, 
identified by a mouse click or keyboard entry into 
which symbols are placed. 


Symbols displayed as icons - or add your own. 
Features accessed via drop down menus, 
dialogue boxes and multiple windows. 

Wide range of text styles and sizes available. 
Editing by cut-and-paste. 

Links can be "auto" or "manual". 


Published by Systemstar SoftTools Ltd, 
Rg ne Cater ll is available for £160 excluding 
VAT and P&P. Price includes a complete manual 
and examples to help you achieve professional 
results - fast. 


Call for a demonstration disk 


YSTEMSTAR 


SoftTools Lirmited 


1-3 Parliament Square Hertford SG14 1EX 
Telephone: (0992) 500919 Facsimile: (0992) eee) 
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\ ExpoTech Corporation 


ToolsKan 


ToolsKan / VB is the latest piece of software 
from Kansmen Corporation - features 
include: Table control with input validation, 
split windows and colour customisation; 3D 
Chart with over 30 different 2D & 3D Chart 
styles, rotation and scrolling; Toolbox - 
create floating tool-palettes, creates 
buttons from bitmaps or text, supports 
scrolling, 3D buttons with colour 


customisation, single/multiple/no-state button groups; Ribbon/|con Bar: add icon 
bars to application in a flash, supports combo-boxes, text and buttons; Field 
Validation for check date, time, number and custom ‘Pic’ fields; Meter Control - 
vertical, horizontal and circular gauges with a choice of needle or color bar as 
indicator; Status Bar with auto-scrolled text, stretchable field width, coloured 
progress bar, and show date/time/keystates. ToolsKan/VB is supplied as VBXs and 
is provided for Royalty free distribution with your programs. 


++9/OISOg |ONSIA 


Also available ToolsKan for C/C++/Pascal - supplied as DLLs, can be used with 
most applications that support custom controls. 


> £129 < 


For Information Circle: 870 


3 
3 
3 
3 VB Project Archive 
3 
B 
3 


JODSDNd/+4+9/D 


Have you ever worked on a Visual basic project ne 
and found that the change you made didn't re ton EE Wow Boia 
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version? Or, have you given (or sold) your pec a 
program to others and realized that you left out - [tee | 
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a necessary DLL or VBX file? If so, you need VB 
Project Archiver! 


VB Project Archiver is a utility for Visual Basic 
programmers, which allows the user to store all of 
the modules and files relating to the VB project in | 
a single file using one of the popular archiving a = 
programs (PKZip, ARJ, LHA, ZOO and others), without leaving the comfort of 
the Windows Environment. VBPA uses the Makefile to get a list of modules and 
forms used in the project, so there is no need to worry about forgetting 
anything. VBPA will also scan the Global and Code modules for Declare 
statements for Windows DLLs or VBXs that might be used within the project! 
VBPA can even replace design-time Custom-controls with their run-time 
counterparts. WHILE STOCKS LAST WHEN YOU BUY VBPA WE’LL GIVE YOU 
VB-TIDY - A NIFTY VB UTILITY. 


> £79.95 <4 
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Visual Basic/C++ 


Visual Architect © 


DITCH THE GRID! 
ITS TIME TO USE A TRUE | 
SPREADSHEET CONTROL! < 


The ‘True’ spreadsheet control, makes Visual 

Architect stand out from any other software 

package. A major design goal was to make the 
spreadsheet extremely flexible and powerful. 

It can be used within your application as a functional spreadsheet - as a 

simple way of obtaining variable lines of data from the user - or as an easy 

way of displaying tables of information from a database. .< 


Because of its unique flexibility, the soreadsheet can be customised for each 
individual user. It can optionally be locked so the user can’t make changes. 
The width and height of columns and rows may be changed. The font, 
colour and data type may be changed for any row, column or cell. Cells 
can have the following data types: Edit, Date, Time, Integer, Float, Static, 
Formatted Picture, Combobox, Button and Picture. 


> £1954 \ 
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Image Format / VBX« 


Visual Basic and Visual C++ users can now add 
the power of imaging to applications without 
making a single function call! The Accusoft 
Image Format Library/VBX lets visual 
programmers add complete support for twelve 
raster file formats in less than 30 minutes! 
High-quality image display, with automatic 
support for panning and scrolling- It is so easy 
you'll be amazed! Zooming In and Out is as 
simple as setting a property. Also included are 
some image processing functions for modifiying 
brightness, contrast and sharpness. 


maximize the display quality of all images - 24 bit images are colour quantized 

and colour smoothed for terrific results in 4 & 8 bit display modes. 8 bit images 

are displayed using colour dithering in 4 bit display modes to provide near 8 bit 

mode quality. All image processing functions are implemented as properties of 

the custom control - to invert an image, you would simply set the invert 

property to true. The library supports TIFF, PCX, JPEG, TGA, BMP, WMF, WPG, DIB, / 
DCX, EPS, GIF and PICT. And of course there are no royalties!! 


> £345 <q 


The Accusoft Image Format Library/VBX uses several proprietary algorithms to ‘ 


ExpoTech Corporation 


3 WindowsMAKER Pro 


2 WindowsMAKER Pro is an object-oriented 
es! = oplication C/C++ Code generator that 
builds complete Windows v3.X applications. 
Prototype the entire user interface (menus, 
dialog boxes, child windows, buttons, 
controls, etc.) in a point and click WYSIWYG 
screen designer. Animate the user interface 
to instantly test the look and feel of your 
program without a lengthy compile, then 
generate C source code with all the 
necessary production files to make a complete Windows application. Any 
added custom code is preserved during code regeneration. WindowsMAKER 
Professional handles message processing, memory management, debugging, 
compiler settings, MDI and more. WindowsMAKER generates excellent quality C 
code, and with the optional Switch-It modules you can also generate C++. Alll 
the generated code is highly documented, so hand-modification is easy. It can 
also helo you move DOS or Mac programs to Windwso in record time. 
WindowMAKER Pro is invaluable to anyone writing in C. All code generated is 


royalty free. 
ay = 
= vw ™ 
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Out of Controls 


Out of Controls is a set of 5 Custom controls for 
use within Windows. The controls include: Spin 
Box Control with full function edit box, spin 
selected or default field, date, time, numeric or 
custom styles; Modal Spawning Library for 
opening DOS/Windows and not returning control 
to the main program until the spawned 
application has terminated; Multi-Cell List Box 
includes check box, radio buttons and editable 
text cells, rows may contain multiple cells of any 
type, automatically scrolls vertically and 
horizontally, allows rows to be reordered by drag 
and drop; Text Editor Library adds an editor to an application in second. 
Provides file, print, edit, clipboard and search options. Supports files up to 
32k in size; Line Object Editor in which each object may be configured as 
either mixed or movable against the ruler, as fixed size, resizeable or split 
and rejoinable. Allows mutliple category rows for sorting objects and also 
supports customised ruler formats. 
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Out of Controls comes complete with 150+ page manual and examples. 


Source Code available. as a 
iy & 
> £195 <4 
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Dyad M++ 


M++ provides a complete multi-dimensional (up to 
4 dimensions) array language extension to C++. 
M++ includes both LINPACK linear system classes 
and EISPACK eigensystem classes and allows the 
user to perform array manipulations, numeric 
operations on arrays and sub-arrays, as easily as 
on scalars. An important feature of M++ is the 
ease with which users of APL, MATLIB, GAUSS and 
array languages can quickly write code in a similar array program style. The 
M++ Class Library provides methods and functions for array, matrix and vector 
manipulations as well as a full complement of linear system and eigensystem 
analysis classes. M++ enables the solution of most difficult array handling or 
advanced scientific programming problems quickly and easily without 
sacrificing algorithmic control or program performance. M++ release 4.0 
provides additional array types (BitArray and PointerArray) with an expanded 
set of functions and methods including FFTs and convolutions for float, double 
and complex arrays. FFTs can be performed on vectors or arrays of vectors as 
well as performing multi-dimensional FFTs. Likewise convolutions can be 
performed on vectors or matrices. 


> £195 < 
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object Menu v2 


object-Menu v2.0 provides an object-oriented 
architectural framework for your application. The eer en Mbit ay oe ar ome 
intuitive architecture and natural programming — FF ; 

syntax increase your productivity more than you 
ever thought possible. Seamlessly port your 
product between DOS graphics and 
MS-Windows using the interface objects. Give 
your Windows applications a facelift: the library 
includes extensive icon capability and optional 
Motif-Styling not found in other Windows API's. 
Create your own objects easily by extending our 
class poses object-Menu includes windows, 
icons, scroll bars, menus, buttons, toolbars, dialog boxes, data entry, spin 
control, file chooser, comboboxes, justified page display with embedded 
icons and hypertext primitives, and much more. Special features: 
dynamically change scroll bar resolution, multiple line items, multiple icons 
for a menu item, several menu styling and item selection options, compact, 
natural programming syntax. Special DOS features include help and icon 
libraries, hypertext helo system, event management and an overlapped 


> £295 < 
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Diamond Toolbox 


Diamond Toolbox is seven packages in one: 
Cockpit, Revision Control, Loadit, Helplt, Field 
Validation, Gadget Library together with the 
actual toolkit and source code. 


Using Cockpit, the advanced workbench and 
revision control system, you are only three clicks 
away from your first Windows Application, Cockpit 
handles resource, make, include, definition and 
source files. You only have to deal with the 
functions and projects. Loadlt is a powerful 
installer that requires no compilations for generating setup configurations. 
Loadlt supports dialog boxes, bitmaps, background fountain fills. Helplt is a 
lightning speed help interpreter - using the hypertext style programming 
language you can create on-line help on the fly. Field Validation uses 
COBOL-like patterns, real time validation, range checking, large number of 
data types such as money, text, date, time, and with international support it 
is the most powerful data entry package on the market. Smart Objects can 
be moved, resized, modified, enabled, disabled, removed and their relative 
position (front/back) changed. Objects include balloon help, meters, 
gauges, spreadsheets, etc 


> £295 < 
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3 ~~ WinWidgets 


WinWidgets is a set of custom controls for 
Windows. Features include Edit Control, List 
box, Combo box, Cycle Box with smart edit 
masks for data validation hot-linking to ja 
program variables; Button Control - display text | cua. 
and/or bitmaps, animate different button ee 
states, play sounds, also checkbox and 
radiobutton styles; Status Bar, Ribbon Bar and 
Floating Palette enable the user to create a 
great looking professional user interface - it 
can be attached to a window side or float above; Modeless Forms - design 
like a dialog box but it can be displayed in any window; Optional Grid 
control for easy use with databases, add records in a single statement, edit 
and list fields, browse mode, edit in place of spreadsheet style, resizeable 
rows and columns, cut & paste to and from the spreadsheet. Supports 
ODBC and SQL Datatypes. 
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Source code is available - WinWidgets is Royalty free. 
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Visual Basic/C++ 


C/C++/Pascal 


Expolech Corporation 


Image SDK Plus 


The New Image SDK Plus has arrived! 
Read/Write/Print TIFF, PCX, GIF, TARGA, 
MS-Metatfile, Clipboard, DIB and ColorFax 
Format. Image transformation: Antialiasing 
conversion, scaling colour images, bilinear 
or cubic spline interpolation, skew image for 
OCR, rotation in 1 degree increments, 
dithering, display DIB or DDB image, 
compress and decompress DIB, scrolling, 
utility functions, digitize ASCII text. Also available from Black Ice - New TIFF 
SDK for Windows v4, Features include: New High Speed Group 3 and 
Group 4 fax formats, IBM’s MMR IOCA, decompress from memory, 
decompress from every repaint, LZW and Packbit compression, 24 bit 
colour images, chained images. Contains over 50 functions. (£249) 


MA 
Both packages are supplied compete with manuals and example code - 
No royalties. Image SDK Plus and TIFF SDK for Windows work with Borland 
C++, Microsoft C and Visual Basic. 
For Information Circle; 880 


=~ ButtonAid 


ButtonAid enables the programmer to create 
great looking 3D Effect buttons without much 
additional programming. Commands to 
ButtonAid’s DLL are placed in the buttons’ 
caption text, and are processed at runtime. 


Features include: Text, bitmap and text & 
bitmap buttons. 


ButtonAid requires Microsoft C or Borland C++ 
for Windows. 


> £494 
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TE Developer's Kit 


Incorporate text editing features into your 
application easily and cost effectively. 
Features include: multiple files and windows, 
word-wrap, edit large files, reconfigurable 
keyboard and screen colours, undo, 
cut/paste, print, search/replace, word 
processing features such as WYSIWYG, 
indentation, double spacing, centering and 
right justification, imbedded pictures, 
multiple fonts and sizes. The kit also includes TER small editor routine - a 
subset of TE. Your application calls this routine by specifying the window 
location and size, maximum file size and an input buffer or file. Includes the 
complete ‘C’ source code, 


TE Developer's Kit v3.5 is available for DOS, Windows, OS/2 PM. Also 
available is Spell Time a full featured spell checker that can interface with 


TE if required; ChartPro a charting DLL that can draw 3D bar, pie, line/area 
and hilo graphs; Report Ease a form layout editor and report executor. 


> £249 < 


For Information Circle: 882 


Drovers Toolbox .. 


System 


With 23 custom controls, including FarPoints 


industry unique full-featured spreadsheet control erarshs iste iei as 


(not a grid!), Formatted Editor Controls, Tool Bar = | 
and Status Bar, ability to add 3D effects to dialog 
boxes, View Pictures with animation, and 
Enhanced Listbox this package is a developer's 
dream come true! 


Over 300 functions are built in, including DOS 
System functions, Data/Time support, String 
Functions and Enhanced file support. 


Drovers Professional Toolbox supports MSC 7.0, Borland C++, Turbo Pascal, 
Actor, WindowsMaker Pro, Borland Resource Workshop and Dialog Editor. 
Drover’s Professional Toolbox for Windows does not require any Royalty 
payments. 


Users of Drover’s v2 - v3 upgrades are now available please contact us for 
more details. 
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RAD 


Rad is written by Clipper 
programmers for Clipper 
Programmers! 


Visual Basic/C++ 


RAD (Rapid Application Development) is the latest product from Paul Sheriff & 
Associates, RAD is a complete application generator for Clipper 5, it includes 
Screen Painter, Menu Maker, Report Writer, Data Dictionary, Documentor, 
On-Line Help Generator and lots more! 


C/C++/Pascal 
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Telepathy 


Telepathy is the most powerful and complete 
serial communications library ever developed 
for Clipper. Telepathy makes it easy to add the 
communication functions you've always 
wanted in your Clipper applications. For 
optimal performance, a powerful ‘notification’ 
mechanism allows Telepathy to process data 
in the background and supports the direct use 
of serial devices such as bar-code wands in 
place of the keyboard. 


Telepathy supports the most popular binary file transfer protocols: Xmnodem (and 
Xmodem-CRC and Xmodem-1k), batch-modem Ymodem and Ymodem-G, 


Kermit, and Zmodem. Progress functions are one of Telepathy’s many unique ‘ 


Clipper/Xbase 


features. During a transmission, your own user-defined function will be called at 
various times (start or end of transmission, end of a block, or on a protocol error) 
to allow you to update screen displays and control the progress of the transfer. 


Also included are Terminal Emulators for TTY, VT102 and ANSI. Each of Telepathy’s 
terminal emulators accepts a user-defined function to give the programmer 
complete control of the terminal session. 
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EZ-Install 


Now Your Software Can Have A 
Comprehensive Professional 
Installation Routine In Minutes... 


with EZ-Install v4.0! 


EZ-Install produces professional comprehensive installation routines for 
software products. Includes menu-driven Installation Aid, which steps the 
developer through the installation option, generates the installation 
configuration, then creates distribution disk(s), Checks/modifies user's 
CONFIG.SYS, AUTOEXEC.BAT, Windows .INI files, and system environment. 
Compression, File-splitting utilities and screen builder utilities are included. 


EZ-Install has NO copyright message on the runtime programs, NO copy 
protection and NO royalties payable on distributed installation programs. 


£195 < 
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RoboHELP 


RoboHelp is an automatic authoring tool that 
makes the process of creating a Windows Help 
System just a matter of pointing and clicking. 
RoboHelp guides the user through all the 
necessary steps - the user just fills in the actual 
help text when prompted. 


RoboHelp is the fastest way to create Help 
Systems for Microsoft Windows v3.X. It includes 
State-of-the-art Visual programming technology 
making development of professional on-line 
Windows Help Systems intuitive. It even generate 
all source code (RTF) and production files (H and HPJ). 


RoboHelp generates source code for: Indexes, Topics, Keywords (for search), 
Context strings, Browse Sequences, Defined Terms, Pop-Up Definitions, 
Displaying Graphics, Bitmap Hot Links, Cross References and Hypertext links. 


RoboHelp supports upto 200 files per project, 1600 Topics per file, and uptto 
320000 Topics per Help System. It requires Word for Windows and Windows 


Help Compiler. b> £29 5 «4 
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Until the End of July 93, 
when you purchase 
any” Dev. tool from 
ExpoTech- we'll send 
you a copy of Central 
Lite (worth £49.95) free. 
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Central Lite is the great 
new Program Manager 
replacement from 
SpringTime Software. 


__C/C++/Pascal. 


Free Gift 


Central 
. i el 


* This offer is limited to one per person, you must also specify that you 
the free gift at the time of ordering. ExpoTech will not offer any 


Clipper/Xbase _ 
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Ordering Info 


For more information on any of the products 
shown, please contact our Customer Services 
department who will be happy to assist you. 


CORPORATION 


The Leaders in Development Tool Distribution 


Tel: +44-(0)273-749222 
Fax: +44-(0)273-746446 
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TCP/IP 


Practical TCP/IP 


After last month’s tour of Internet, Laine decided he should explain some of the protocols 
that make it work, and tell you where to get source code implementing the protocols. 


When I started writing this article, my 
objective was simply to show, in C++ 
code, how to write a program that 
communicated with another machine 
on the Internet using the TCP/IP ‘Tel- 
net’ virtual terminal protocol. As I got 
further and further into the explana- 
tion, I realised that, without knowing 
some lower level details of TCP/IP 
itself, although you would be able to 
type in the code and run it, you might 
not understand what was happening 
when you did so. By the time even the 
most essential explanations were fin- 
ished, my space was neatly filled. I 
then decided that, rather than trying to 
short change you on low-down details 
just to fit everything in, I should rather 
fill in some of the blank spots in this 
general explanation of TCP/IP, and 
save the Telnet program for next 
month (in the meantime, augmenting 
it with implementations of a few other 
useful TCP/IP utilities). 


Basic TCP/IP 


We all know that the Internet is based 
on ‘TCP/IP’. But just what does that 


mean? TCP/IP is not a program (just 
like the Internet is not a network). It 
also is not a protocol. Rather, it is a 
suite of protocols, the most important 
of these being TCP and IP. 


TCP stands for ‘Transmission Control 
Protocol’. A TCP packet contains infor- 
mation about which session of which 
protocol (or, in simpler terms, which 
process on the remote host) the packet’s 
data is intended for. A TCP sender 
must hand an outgoing packet to IP 
(see below) and wait for the acknow- 
ledgement (ACK) from the other side, 
retransmitting if the packet is damaged 
or not received. The TCP receiver is 
responsible for checking the integrity 
of the received data packet, sending 
an acknowledgement back to the 
sender, sequencing this packet relative 
to other received packets, and deliver- 
ing the data to the proper process. TCP 
also handles flow control, to make sure 
that a process on one host does not 
swamp another. In summary, TCP han- 
dles the end-points of a full duplex, 
reliable data stream, knowing nothing 
about what happens in between. 
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Figure 1 - 
A TCP Packet inside an IP Packet inside an Ethernet Packet 


IP 


TCP does all its sending and receiving 
using IP (‘Internet Protocol’). IP makes 
no attempts at interpreting the mean- 
ing of the data in the TCP (or other 
kinds of) packets, or even checking 
the integrity of the packets. It is only 
concerned with getting these packets 
from the source host to the destination 
host. All routing of packets to help 
them find their way through the het- 
erogeneous jungle of Ethernets, mo- 
dems, T1 data lines and whatever is 
handled by IP (and some sibling pro- 
tocols). IP does its routing using ‘IP 
Addresses’ (discussed last month). 
Each IP packet header contains the 
source and destination IP addresses. It 
also contains a ‘Protocol’ field, which 
is set to ‘6’ for TCP packets. 


Note that, although IP does a check- 
sum to verify the integrity of the IP 
header, it makes no attempt at validat- 
ing the data in the packet - as that is 
done by TCP anyway, it would just be 
a waste of CPU time. IP is what is 
sometimes called a Datagram service. 
It makes a best effort attempt to deliver 
packets, but does not verify or guaran- 
tee their delivery, and rather obviously 
cannot automatically retransmit dam- 
aged or lost packets. That’s up to the 
higher level protocol (TCP in our case). 


Although in practice these two proto- 
cols are implemented together, the con- 
ceptual division helps immensely when 
trying to understand how it all works. 


Wrapping and Tunnelling 


While connections between nets are 
usually done with some kind of point- 
to-point link (modem, ISDN), the most 
common form of local net is Ethernet, 
and Ethernet has its own packet for- 
mat. Rather than stripping off the IP 
header (which would be disastrous if 
the destination was not on the local 
net!), the entire packet, header and all 
is wrapped up in an Ethernet packet. 
Therefore, when your program sends 


_EXE Magazine, Vol 8, Issue 1, June 1993 5 


out a TCP packet to a program on 
some remote system, what is really 
sent is a TCP packet, encapsulated in 
an IP packet, encapsulated in an Eth- 
ernet packet. Figure 1 shows what the 
resulting conglomeration looks like. 


Something similar happens when you 
send IP over X.25, IPX (Novell), 
Arcnet, or any other protocol (whether 
hardware or software imposed). This 
practice of sending one protocol 
wrapped inside another is sometimes 
called ‘tunnelling’, and is the key to 
TCP/IP’s connectability. IP packets 
contain no hardware layer specific in- 
formation, meaning that an IP packet 
can travel anywhere, on any media 
(even by surface post on a magnetic 
tape, if you are masochistic and set 
some reeallly long time-outs). 


Address Resolution 


An interesting note concerning the 
sending of IP over Ethernet is that IP 
likes to send packets to an IP address 
(an abstract number, not based on 
anything worldly except the manager 
who assigned it) (however worldly 
that may be), but Ethernet cards want 
to send the packet to an Ethernet 
address (a concrete number, hard- 
wired into the Ethernet card when it is 
manufactured). Although it is possible 
to send special ‘broadcast’ packets on 
Ethernet, doing so for all packets 
would force every machine to examine 
every packet, causing great load on the 
machines, especially PCs. To make the 
net run efficiently, we must determine 
the Ethernet address for a given IP 
address before we can send an IP 
packet over Ethernet. 


Another protocol, ARP (Address Reso- 
lution Protocol) comes to the rescue 
here. ARP is at the same level as IP (ie, 
not encapsulated in IP, as is TCP). In 
simple terms, when it becomes neces- 


(quote of the day) 


(Simple Mail Transfer) 
(Domain Name Server) 


(Remote Procedure Call) 
(NetNews Transfer) 


Figure 2 - Some well known 
TCP Port numbers 
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sary to send an IP packet to a pre- 
viously unencountered IP address, 
ARP sends out a single broadcast mes- 
sage to the local net, asking ‘Which 
one of you has IP address n.n.n.n?’ The 
machine with that IP address responds 
‘I have that IP address, and my hard- 
ware address is h:h:h:h:h:h’ (Ethernet 
addresses are 48 bits.) In the case that 
the host with the IP address in question 
is not on the local net, a router con- 
nected to the net must ‘lie’ and claim 
that it has IP address n.n.n.n. In either 
case, subsequent IP packets will be 
sent to the given Ethernet address, 
either directly to the remote host, or to 
the router for forwarding to another 
net. Aside from an occasional ARP 
broadcast, each machine on the net 
will receive only its own packets. 


ARP, by the way, is also usually imple- 
mented as part of the TCP+IP library. 
In particular, it is tightly intertwined 
with IP. 


TCP Details 


After giving an overview of how the 
packets get from one host to another 
(IP + ARP), let’s forget about that, and 
assume that all TCP packets created on 
one host magically appear on the 
other. Most of the time. What is inside 
these packets, and how are they inter- 
preted? 


A look at the packet diagram (Figure 
1) shows that each TCP packet has a 
‘source port’ and a ‘destination port’. 
In combination with the IP addresses 
of the source and destination (from the 
IP header), these two ports determine 
both which protocol the packet is for, 
and which process it is going to. I say 
‘combination’ because the interpreta- 
tion changes based on which side of 
the connection we are. 


TCP protocols are all based on the 
concept of client and server. A server 
‘passively’ listens for a connection us- 
ing a particular well known port num- 
ber (eg 23 - the port number for Telnet) 
as the source port. A client can then 
‘actively’ open the connection using 
the well known port as destination, 
and some other currently unused port 
as source. After opening, incoming 
packets on either end are given to the 
proper processes by checking the 
‘source IP+port/destination IP+port’ 
pair, which is guaranteed to be unique 
for any connection. The result is that 
server processes can listen on standard 
port numbers for standard protocols, 
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while multiple connections using the 
same protocol can be made simultane- 
ously to the same host without danger 
of ambiguity. 


Several ports (protocols) have been 
defined for TCP - Telnet, FTP, SMTP 
(Simple Mail Transfer Protocol). Figure 
2 shows a list of some ‘well known’ 
TCP port numbers. Remember, this 
number is the number the server lis- 
tens for as, and the client sends as, 
‘destination port’. The source port (in 
packets from the client) can be any 
other number. 


Although different protocols use differ- 
ent port numbers, the method of read- 
ing and writing the data is the same for 
all. Only the interpretation of said data 
changes. 


Once a TCP connection is open, the 
data bytes of the packets can be treated 
as a reliable stream of bytes, sort of like 
a sequential file. No record length or 
other structure is placed on the data by 
TCP itself, and there is no guarantee 
that data will arrive in chunks of a 
certain size. However, you are guaran- 
teed that the 201st byte will be deliv- 
ered to your application before the 
202nd byte, and that every received 
byte is correct. 


BSD Sockets 


To make reading and writing data on 
TCP connections easier for application 
programmers, the designers of BSD 
Unix created a concept called sockets. 
A TCP socket is (just as an electrical 
socket is) a connection to the rest of 
the network - in particular, to the 
process on the remote host. 


In BSD, a socket is opened with a 
special function, socket (), which 
returns a descriptor number similar to 
that returned by the file open () func- 
tion. After opening the socket, it must 
be bound to a particular source port 
by calling the bind() function. To 
complete the opening process and es- 
tablish the connection, the server waits 
passively with accept (), while the 
client actively attempts the connection 
with connect (). 


Although there are special functions 
available for reading and writing to 
open sockets, it can also be done with 
the same library functions that read 
and write files. Closing a socket is also 
accomplished with the standard Unix 
close() function. (Internally, these 
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functions determine whether to do 
socket I/O or disk I/O according to the 
descriptor number.) 


BSD can combine the TCP and file 
functions in this way because TCP/IP 
is built into the BSD kernel - it’s always 
there. Us humble folks trying to write 
programs for DOS don’t have this level 
of consistency - DOS comes from one 
vendor, the compiler (and its library) 
comes from another, and the TCP/IP 
library from yet a third. 


TCP/IP for DOS 


Even before Bilkent was connected to 
the Internet, I was curious about 
TCP/IP. I wanted to write comms pro- 
grams using TCP/IP, but didn’t have 
the time (or the desire) to implement 
the entire suite from scratch. Looking 
around for ready-made libraries, I only 
saw expensive packages (sometimes 
so expensive that they were afraid to 
quote a price in the ad) of questionable 
clarity (beware of an ad for software 
that says ‘consulting services available’). 


During the last few months of our 
BITNET era, I managed to find a few 
‘free’ TCP/IP implementations for DOS 
via ftpmail, and just recently found yet 
another with anonymous ftp. For those 
who are anxious to dig into source 
code, the most interesting were: 


// (note - s param is actually tep Socket *) 


// for opening a tep socket 
int tep_open(void *s, word lport, 
longword ina, 
word port, 
int (*datahandler) ()); 
tep_listen(void *s, word lport, 
longword ina, 
word port, int (*datahandler) (), 
word timeout); 
int tep_established(void *s); 


// reading from a socket 

word sock_dataready (void *s); 
sock_read(void *s, byte *dp, int len); 
sock _fastread(void *s, byte *dp, int len); 
word sock_gets(void *s, byte *dp, int n); 
byte sock_getc(void *s ); 

sock_scanf (void *s, char *format, ...)7 


// writing to a socket 
sock_write(void *s, byte *dp, int len); 
void sock_enqueue(void *s, byte *dp 

int lei 
sock_fastwrite(void *s e *dp 
sock_puts (void *s, byte *dp); 
byte sock_putc(void *s, byte c); 
sock printf (void *s, char *format, ...)7 


int len ); 


// other control/status/etc 
sock_flush(void *s); 
sock_flushnext (void *s); 
sock_close(void *s); 
sock_abort (void *s); 
sock_mode (void *s, word mode) ; 
sock_wait_established(s, seconds, fn, 
statusptr); 
sock_wait_input(s, seconds, fn , 
sock_tick(s, statusptr); 
sock_wait_closed(s, seconds, 


statusptr) ; 


fn, statusptr); 


Figure 3 - List of WATTCP 
functions 


68 .EXE Magazine, Vol 8, Issue 1, June 1993 


KAIQ 


This package was written by Phil Karn 
(Ham callsign KA9Q) primarily to al- 
low ham radio operators to network 
their computers via shortwave radio 
using a special type of ‘broadcast mo- 
dem’ (the best term I can think of). 


TCP/IP is not a 
program (just 
like the Internet 
is not a 
network). It 
also is not a 
protocol 


KA9Q also includes hardware interface 
modules for serial port (SLIP and PPP), 
Ethernet, and generic packet drivers (a 
hardware independent interface for net- 
work software). KA9Q contains a full 
TCP/IP implementation with integrated 
applications for most of the popular 
protocols: telnet, ftp, smtp, etc. The C 
source code for the entire package is 
available, although the documents say 
that it is freely usable only for radio 
amateurs and academic institutions. I 
haven’t looked at much of the code, 
but it can’t be too bad, as Phil Karn 
even has a TCP-related algorithm 
named after him. Although there may 
be a more recent version somewhere 
else, I got the KA9Q source code from 
oak.oakland.edu: pub/msdos/ka9q- 
tepip/s920603.zip (the number is a 
date, so it may change). 


Aside from distribution restrictions, my 
main problem with KA9Q was that it 
was written as a single, self-contained 
program. Although I didn’t investigate 
deeply, the application side of the 
protocols seemed too tightly integrated 
with the protocols themselves. On the 
other hand, KA9Q has IP routing built 
in to its kernel - a PC running KA9Q 
makes a quite serviceable (although a 
bit slow under load) TCP/IP router. 


NCSA Telnet 


This is a Telnet application plus several 
other TCP type applications written by 
folks at the National Center for Super- 


TCP/IP 


computing Applications. Full source 
code, in C, is freely available to anyone 
who wants it. There are no restrictions 
on use, redistribution, even copyright- 
ing and sale of the programs or their 
source. You can find these files in 
several places, but a good one is 
dorm.rutgers.edu: pub/msdos/ 
NCSA_Telnet/msdos/tel2306s.zip. 


Again, reading the documentation 
gave me the feeling that the TCP/IP 
functions were written first with the 
idea of supporting the NCSA Telnet 
program, not as a stand-alone, generic 
TCP/IP function library. There was 
also some confusion in the organisa- 
tion. Although there were net xxx () 
functions (low level) and Sxxxx () 
functions (session level), it wasn’t re- 
ally clear when to use which. Some- 
times suggestions were made to use 
functions from the two levels in com- 
bination with each other. 


Waterloo TCP 


This is the library I chose, for several 
reasons. First, it was designed not as a 
part of a single application, but to be 
used as a general purpose library for 
any TCP application. Second, it 
seemed to me to be the best organised 
(externally at least), using a socket 
paradigm similar to BSD. Most of the 
function calls can be directly mapped 
into an appropriate C++ class or two. 
Third, although there are restrictions 
on distributing modified forms of the 
library, or selling the library itself for a 
profit, you can freely distribute the 
library unmodified, and sell derived 
applications for a profit. The original 
library is available from dorm.rut- 
gers.edu: pub/msdos/wattcp 
/wattcp.zip. 


Figure 3 shows a list of the socket 
related functions in WATTCP. Note 
that most of them are related to either 
reading or writing a socket. As the only 
thing changing from one protocol to 
another is the port number and the 
interpretation of the data stream, not 
much is left for the application pro- 
grammer to do (ha ha). 


Included with WATTCP are the source 
code for several standard TCP/IP ap- 
plications, including FINGER, PING, 
LPR, LPQ, COOKIE, and several oth- 
ers. There is even a program that in- 
stalls a telnet client over the INT 14h 
serial port interrupt, allowing you to 
use a standard serial comms program 
for telnet. Perusing these programs will 
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informative 128-page catalogue, Toolbox 


teach you a lot about WATTCP, but if 
you really want to get the lowdown, 
you can order a reference book di- 
rectly from the author (he swears he’ll 
only use the money to improve 
WATTCP) - details in the doc files. 


Trying it out 

You don’t need to be connected to the 
Internet to run WATTCP programs. 
WATTCP uses the ‘Packet Driver’ inter- 
face to communicate with the network 
hardware. (A packet driver uses a set 
of standardised interrupt calls to send 
and receive packets on vastly diverse 
types of hardware.) If you aren’t fortu- 
nate enough to have a network lying 
around, you can easily set one up by 
connecting two PCs with a null modem 
cable and install a SLIP (Serial Line 
Internet Protocol) driver on each. The 
proper driver, and batch files to start 
up this simple TCP/IP network, are 
included on this month’s disk (or on 
firat.bcc.bilkent.edu.tr in pub/Lo- 
cal/Cplusplus/simplenet.zip). 


Even if you already have a TCP/IP 
network set up, you'll still have to load 
a packet driver to run WATTCP de- 


rived programs. Drivers for nearly 
every piece of communications hard- 
ware ever invented can be found on 


Always be wary 
of an adver- 
tisement for 

software that 
says ‘consulting 
services 
available’ 


oak.oakland.edu: pub/msdos/pktdrvr 
/drivers.zip (Watch out! This file is 
over 300 KB!) 


Now, where did I put that Ronco 
Pocket Classmatic? Gotta churn these 
socket classes out... 


(To be continued) 
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Although he bas taught C++ and OOP 
at Bilkent University for the last three 
years, by the time you read this Laine 
will have given his last exam. He and 
JSamily (== wife + cat) will be departing 
for destination unknown in the near 
future, but the magic of mail forward- 
ing should keep his email address 
valid: laine@firat.bcc. bilkent.edu.tr. 


Much of Laine’s code is available by 
anonymous ftp from the same address 
in directory pub/Local/Cplusplus. Log 
in as user ‘ftp’ and give your email 
address as password. For the Internetly 
challenged, Laine’s bits and pieces are 
also available for free on disk, provided 
you follow the rules given in column 1 
of the Contents page. Mark your enve- 
lope ‘TCP/IP’ to obtain this month’s ma- 
terial. 
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Aone line command encrypts any .EXE or 
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Mayhem 


Jules has been telephoning all kinds of people, researching 
for the worst award in the business. 


Although it’s a very unfashionable 
view, I have to say I have very little 
sympathy with FAST and its ilk. FAST 
would have us believe that the custom- 
ers of software products are queuing 
up to steal the publishers’ hard-earned, 
and the poor publishers need all the 
protection that can be legislated. It’s 
rubbish, and it’s clearly rubbish, as the 
thousands of shareware suppliers who 
earn good livings and, in some cases, 
small fortunes, stand witness. 


To some extent, the problem is caused 
by the suppliers themselves. Not even 
the sorriest hacker will boast about 
using PubliCad without having paid a 
$40 registration, but to boast that they 
have completely undongled MegaCad, 
and it’s no better, but you can have it 
for what it’s worth instead of $5000 - 
aye, there’s something to be proud of! 


They’re proud because they, like me, 
and like the shareware publishers, 
think that MegaCad is overpriced. 
What do you get for your money? You 
get the disks, of course, along with all 
the brain power that went into record- 
ing them; you get the printed manuals, 
you may get a little piece of plastic that 
fits nicely over the function keys until 
it disappears behind the filing cabinet, 
and you may get a little reference card 
that does its job quite nicely until it is 
pressed into service as a fly-swatter. 
People can copy disks, of course, and 
if they’re really determined they can 
photocopy the manual, but if someone 
is prepared to waste a day at the 
photocopier, they probably wouldn’t 
be able to justify a copy of the pro- 
gram. 


But most of all, the thing that no 
sensible user would consider operat- 
ing his software or hardware without, 
is the technical support. The users 
can’t copy this. They have to subscribe. 
The only sensible way to select a soft- 
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ware package, after ‘will it do the job?’ 
is ‘will it go on doing the job?’ Forget 
the myriad features, the user-friendly 
keystrokes, or the pretty graphics; if 
the software can break taking live data 
with it, you have to have some kind of 


Now we’re part of 
Europe (if that’s 
what we are) 
poor support will 
not do - we will 
lose business 
because of it 


support. What a user is buying into is 
not clever programming or complex 
maths, he is buying a tool that will 
solve his problems for him. 


This is why shareware works. These 
people are no less professional than 
the big companies, though they oper- 
ate at a smaller scale. Their programs 
tend to be more compact, and there- 
fore more reliable, and when you 
phone them, you know you're talking 
to the people who understand the 
software; you know they'll get it fixed 
if they’re still in business twelve 
months after they’ve released their 
product, and there’s a good chance 
they'll still be at their desks at 9pm. 
Shareware tech support is either non- 
existent or excellent. 


Would that the same could be said 
about the larger companies! MegaCad 
(use your imagination) refused to give 
me any technical support whatever, 
because the version of its software I 
was running happened to be Ameri- 


can, even though it was supplied to me 
by the UK office. Microsoft told me, 
after four weeks of describing a fault 
to them, ‘Yes, it’s a bug. Don’t do 
whatever causes the bug to be ex- 
pressed’, And it is totally unacceptable 
for a support line to say, as one did 
two weeks ago of a fault which repeat- 
edly and repeatably shut down the 
entire system, ‘We have no ideas. If 
you figure it out, be sure to let us 
know’. 


Technical support is part of the prod- 
uct - indeed, it is where most of the 
perceived value lies. To supply a prod- 
uct and then refuse to support it effec- 
tively is fraudulent. To charge stupid 
prices for software that doesn’t work, 
and then complain that people are 
poking inside it because the publisher 
refuses to fix it is childish. This is why 
this year’s award goes to support lines. 


Ihave a feeling that, in the UK, we get 
particularly bad support. The best sup- 
port seems to come from the US and 
France, and the worst (and rudest) 
support I have ever had has been from 
British and German companies. When 
we were an island, that didn’t matter 
too much - we just gritted our collec- 
tive teeth and put up with it, but now 
we're part of Europe (if that’s what 
we are) it will not do - we will lose 
business because of it. Frankly I think 
the Brits have a 
problem 

with service, 
seeing it as 
subservient 

or demeaning, 
and the 


countries which don’t have these 
hang-ups seem to produce better 
salesmen, more comprehensible ex- 
perts, and of course more effective 
techsuppott. 


So, without any apology, I’m making 
both awards to British companies. The 
runners-up award goes to Ashmount 
Research, creator of Off Line Readers 
(OLRs) for various email systems. Al- 
though it makes good products, which 
work very well most of the time, Ash- 
mount’s support is dreadful. Over a 
period of two months, the company 
replied to email late Cif at all), it an- 
swered its phone only once (‘They're 
all out. Don’t know when they'll be 
back’), never once returned a call, and 
finally came up with the ‘No ideas’ gem 
I gave earlier. That just doesn’t cut the 
mustard, and I reckon the company 
has lost sales because of it. 


But the first prize goes to a company 
that is running an operation which I 
feel is not merely sloppy but deceitful. 
Amstrad seems to have no quality as- 
surance on its products (I have never 
yet had anything that didn’t have to be 
returned under the guarantee), some 
products have known design faults, 
yet the support line is an 0898 number 
(45p per minute, 38p cheap rate - and 
forget trying to talk to anyone at cheap 
rate). After listening to an unreason- 
ably long recorded 


) 


only suggestion I have ever had is to 
contact one of Amstrad’s authorised 
engineers. It doesn’t sell spares, it 


It is totally 
unacceptable for a 
support line to say 
‘We have no ideas. 
If you figure it out, 

be sure to let us 
know’ 


won't even accept fault or bug reports, 
and ‘advice’ is a dirty word. You need 
the support line, though, because the 
little man at the end has to go and look 
up the authorised engineer 
for your area, which 

takes another five 

minutes. 


message, the US 


Mayhem 


Amstrad’s equipment is cheap. I know 
it’s built down to a price, and I know 
you get what you pay for. I can’t help 
feeling, though, that the company is 
trying to make its profit on telephone 
support, knowing that the stuff is going 
to break. That, as the saying goes, is 
not fair. 


Congratulations, Amstrad. Your award 
is on its way to you. I know you’ve 
worked hard for it, and you richly 
deserve it. 


EXE, 


Jules’ answering machine is expert in 
all kinds of technicalities. You can 
speak to it, 24 hours a day, on 0707 
644185. 
jules@cix.compulink.co.uk, 
and he will speak to his answering 
machine on your 
behalf. He vigor- 
ously denies sup- 
porting 
Spurs, 


You can also mail 
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The right solutions for Pro 


ect Management 


& Departmental Management 


With the best advice, support, training and a 


Deepak Sareen Associates are the UK's leading distributors of Project 
Management Software. We offer a comprehensive range of solutions to meet 
every project planning or departmental management need. Whether you 
require a simple scheduling and presentation tool or a more sophisticated 
solution, you'll find exactly the right system below. And for a limited period 
only, they come at our special unbeatable prices. Don't miss out - order today 
using the coupon. Or contact us for advice or more details. 


ON TARGET 


Almost everyone manages projects, but for 
80% of managers conventional project 
management software, however well 
designed, can seem too complex. We offer 
the three best and most cost- effective 
solutions to help managers achieve their 
goals - Schedule Express, On Target and 
InstaPlan. We also offer Guide Line which 
lets anyone plan replicable projects 
quickly and easily. 


SCHEDULE EXPRESS” 


On Target is positively the easiest to use 
project management system. It achieves 
this with a combination of an excellent 
use of the Windows environment and by 
providing exactly the right level of 
functionality for 80% of potential users. 
Quick and easy Windows-based project 
planning and tracking, with simple 
duration-driven resource scheduling. Use 
it to produce reports, update and revise 
plans, keep every project in control. And 
as your expertise grows and if your 
requirements become more complex, you 
can easily upgrade to Time Line for 
Windows, which will even read your 
existing plans. 


" excellent package for the occasional project 


Which Computer "BEST BUY" 1992 


The world's first Windows-based graphical 
scheduling tool, designed to transform the 
way you produce and present schedules. 
Lets you creates presentation-quality 
schedules in minutes. Incredibly easy to 
learn and use, it gives you complete 
control over the look of your schedules: 
highlight individual phases, responsibilities 
and requirements with nine different task 
box styles; select different fonts, type 
styles and justification to vary emphasis 
and create impact; choose any timescale 
from minutes to years; add milestones to 
indicate key events; connect tasks directly 
on screen. Also includes: autoschedule 
facility, 3-level task filter and simple 
tracking facility. (Links with InstaPlan, On 
Target, Time Line, Microsoft Project and 
Quick Schedule). 

",..a great value package... The quality of 
output is high. Most project schedulers 


need... to look at paper copy ...This package 
won't disappoint " 


InstaPlan is the easiest-to-use, most - 
cost-effective DOS based tool for 
preparing proposals and planning and 
managing projects. Its easy interface 
with Lotus 123 type slash menus 
makes it ideal for use by Line 
Managers and other occasional users. 
Project Managers welcome its speed 
and functionality for more complex 
project management. InstaPlan is not 
only fast and easy to use, it also offers 
better resource management, costing 
and multi-project facilities than most of 
its competitors costing double the a 
price. We reckon it's unique amongst 
its competitors by offering both ease of 
use for occasional users and the speed, 
resource management and multi- 


Computer Buyer 


"If you need to keep track of your tasks... 
Schedule Express is the answer... really a 
presentational fool more than anything else, 
an one that | found very easy to get along 
with." 


Computer Shopper 


TIME FOR WINDOWS 


TINE The best Windows 

implementation of a Project 
Management system we've ever seen. 
Builds on the strengths of On Target, 
adding effort-driven tasks, individual 
resource calendars, priority-based resource 
scheduling and other features. A nice 
feature, shared with On Target is the 
ability to assign resources at Summary 
Task level as well as Task level. A unique 
feature, the Co-Pilot guides you through 
schedule possibilities, whilst the well 
thought out Icon bar and other features 
enhance ease of use. 


TIME 5 FOR DOS 


Ne Sophisticated task and resource 

definitions allow users to model 
the most complex projects accurately. 
Individual Resource Profiling, Task 
Splitting, multi-project capabilities and 
other features make Time Line 5 the 
choice for larger projects or for 
departmental control, often when Time 
Line for Windows is the choice for 
individual project managers. 


InstaPlan simply the best all-around DOS based PM system. 


project management facilities required for 
_ departmental project management or 
_ programme management, 


Which Computer "BEST BUY" 1990/2 


"Makes sophisticated project ma ment 
fechnlcuee’ highend and easily usable... 


an unbeatable 
PC Magazine (UK) 


Ideal for planning repeatable projects fast 
and accurately, Guide Line stores planning 
knowledge for different types of projects 
in interactive scripts called Guides, With 
the appropriate guide, anyone can create 
a well considered plan on the first try, 
simply by answering the questions asked 
in the dialog boxes. Easy to use, it 
produces complete plans for loading 
straight into your project management 
system in minutes. Comes complete with 
16 free Guides. Also available: Guide 
Line Maker - create your own Guides 
fast, capturing existing project methods 
and estimating techniques. Existing PM 
plans can also be imported to speed 
development. Both Guide Line and Guide 
Line Maker work with Time Line for DOS 
and Windows and On Target. 


Guide Line Open and Guide Line Maker 
Open, available exclusively from Deepak 
Sareen Associates, will work with most 
popular PM systems, including InstaPlan, 
CA SuperProject, MS Project and PMW. 
"Even quite complicated projects can be 

created within about 30 minutes. At a stroke 


this removes one of the biggest hurdles to 
using project management software for 


ordinary business users." PC User 
".. for planning replicable projects quickly 
and accurately, Guide Line 1s far more 


flexibility than just using a template 
prepared in the PM system" 


Linsley Meadows, Systems Consultant, 
British Telecom 


The leading corporate solution for 
controlling and monitoring departmental 
and project time costing and budgeting. It 
also links directly to most popular project 
management packages including: 


- Links to CA purer proted 
InstaPlan, MS Project, On 
Target, PMW and Time Line 


- to dramatically increase project tracking 
efficiency and accuracy. 


Time$heet uses an electronic timesheet to 
provide a "week-at-a-glance" view of all 


current projects by client, project and 
activity, for each user - with up to nine 
levels of detail. A pop-up notepad lets you 
log events associated with each task. The 
flexible report generator lets you compare 
budgeted hours and expenses against 
actual costs over any time period, and 
allows side-by-side comparisons to 
monitor efficiency. 

Great as a stand-alone product, Timesheet 
really comes into its own when used | 
across networks. And, on larger 
installations, you can even use both DOS 
and Windows versions with the same 
database. Time$heet gives you control 
over all project and departmental costs. 
"The biggest advantage of Time$heet 
Professional is its simple operation, so you're 
likely to use it consistently and keep accurate 


records", Infoworld 


Designed as a time costing and billing 

system for professionals, Timeslips will 

also import Time$heet files, allowing you 

to use its billing facilities. 

"Timeslips makes the whole billing pe a 
i] 


lot easier... a good system... Timeslips is 
productive even for users who can barely 


type: What Micro? 


Deepak Sareen can provide you with all 
the help you need to get the right solution 
effectively implemented. We offer a full 
range of product specific and general 
project meng gener training and 
consultancy. If you are not sure which is 
right for you, call us for an informal 
discussion, or see the products in action 
at one of our no-obligation seminars. 


You will see from the order form that we 
are making some unbeatable offers. 
However if your requirement is after the 


close date, or for a larger installation, 
call us for best prices. 


All products 
benefit from our 


60 day unconditional 
money back guarantee 


Using other PM software? 
Cross-grade for just £99.00 


If you are already using other project 
management software, but would like 
to cross-grade to Time Line for 
Windows, Time Line 5 or InstaPlan, 
simply send us a photocopy of your 
system disks or manual showing the 
licence number and you can cross- 
grade for just £99 plus carriage and VAT 


FAX YOUR ORDER NOW TO 


081 423 8992 
FOR MORE DETAILS FAX US NOW 
OR CALL US ON 081 423 8855 


DEEPAK SAREEN 
ASSOCIATES 

Bydell House, Sudbury Hill, Harrow-on-the-Hill, 
Middx HA] 3BR 


> CIRCLE NO. 933 


ORDER N 
Offers close 315 July 1993 


For information tick the products 
that interest you and fax or post to us 


List OFFER 
Price PRICE O'Y TOTAL 


Schedule Express 


Single User or 
Reuhe Mae tiger 179109), 749,950 =e 


InstaPlan Version 4.1 


Single User 

snake ST 199.00. 149.00, =) — 
ON TARGET 

Single User 991003 7:95 ee 
Per Lan Node 79.00 54.95 


TIME LINE for Windows* 
Single User 499.00 299.00 _ 
Per Lan Node 399.00 239.00 _. ___ 
TIME LINE 5 for Dos* 

Single User 599.00 359.00 _. ____ 
Per Lan Node 299.00 189.00 __ 
+ INCLUDES A FREE GUIDE LINE WHILST STOCKS LAST 


GUIDE LINE DOS [] Windows [] 
Guide Line 99.00 74.95 — 
Guide Line Maker 299,00 189.00 — ——__— 
GUIDE LINE OPEN. 
Single copy 149,00 
Pack of 5 , 
GUIDE LINE MAKER OPEN 

(Windows only) 399.00 279.00 — ——— 


Time$heet PROFESSIONAL 
DOS [] Windows [] 


Single User 199.00 179.00 — 

Network edition 

8 user 99.00 629.00 — ——___. 
24 user 1'850) 91,665) == 
48 user 3,500 3,150 — ——— 
100 user 5000:  4;500° = 
D/X Link 79.00 49.00 — —__ 
Your P.M, System? (If any) 

Evaluation System 10.00 FOC — 


Timeslips - send or call for details [] 
SPECIAL VALUE BUNDLES 


10 copies & training at your premises 
On Target & 1 day 1,279 — 
InstaPlan & 2 days + 12:300h ee 
Time Line Windows & 2 days 4,215 — 
All plus consultants travel expenses 
Cross-grade from other PM systems 


InstaPlan V4.1 99.00 — 
‘Time Line for Windows 99.00 __ 
‘Time Line 5 for DOS 99.00 __ 


Please provide proof of ownership 
Total 
Carriage ————— 
& or &10 for 2+ items (12.50 for Next Day Delivery) 
Total inc. carriage SS 
Plus VAT @17.5% 
GRAND TOTAL 
Please call me about training [] 
Disk Size: [] 31/2" [] 51/4" 
Payment Method: [] Visa [] Mastercard [] AMEX 
Less cep TE Er te Pa sc | 


Exp. Date: / / Signature 
(] Cheque payable to Deepak Sareen Associates. 


Name 


Position 


Company 
Address 


Postcode Tel no 


No of PCs in your Department/Organisation 
14{] S54] 10+f] 20+{] 50+[] Over 100) 
Existing PM sytem? YES/NO If so which? 
Do you operate a network? YES/NO 
No. of users? 


XxBASE 


| idéz_jcUL“iG 


OOP with Clipper 


Safer OOP With Clipper 


It’s no secret that you can do OOP with Clipper, but Rob Jackson is not enamoured of the 
syntax. Here is his safer alternative, implemented with the preprocessor. 


Nantucket first launched into OOP in 
a modest way in 1990 with the release 
of Clipper 5. For those who don’t 
know (shame on you!) this took the 
form of class based replacements for 
browsing data, editing data and the 
inclusion of an error system. Almost a 
year later, SuperClass appeared, fol- 
lowed by Class(y) and other add-ons 
that allowed you to define your own 
classes. Now third-party Clipper ven- 
dors are shipping libraries with run- 
time OOP extensions, so their 
products can enjoy the benefits of 
OOP. This amazes (and pleases) me, 
considering that strictly speaking Clip- 
per is not fully object-oriented yet. 


As is often the case with innovative 
software developments, you just can’t 
please everyone. There are certain as- 
pects of programming in Clipper with 
objects that I don’t like. The purpose 
of this article is to show a few simple 
techniques that I use to overcome some 
of the problems that I experienced. 


Error Handling 


I’ve never liked the idea of being at the 
mercy of the run-time error system, (no 


#xtranslate ; 

local <dict> is Dictionary ; 

=>} 

local <dict> := Dictionary () :new() 


#xtranslate Dictionary ; 
<dict> self ; 

=>; 

<dict> 


#xtranslate Dictionary ; 
<dict> size ; 

=>; 

<dict>:size() 


#xtranslate Dictionary ; 
<dict> includesKey <cKey> ; 
=>} 

<dict>:includesKey (<cKey>) 


#xtranslate Dictionary ; 
<dict> removeKey <cKey> ; 
({ifAbsent <excepBlock>] ; 
=> j 

<dict>: removeKey (<cKey>, 
<excepBlock>) 


Figure 1 - Sample 
Pre-processor Directives For 
Dictionary Class 
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matter how sophisticated) if I acciden- 
tally send a message to an object that 
it doesn’t understand. I think the com- 
piler should pick these up. Indeed, if 
you check error C2039 in the manual, 
you'll find that such an error exists... 
although my code never sets it off 


I was finding that this error was the 
major cause of bugs, so I viewed this 
as the most critical issue as far as safer 
programming goes. I also decided it 
would be a good idea to tighten up on 
object initialisation to avoid the other 
major source of problems as well as 
clarifying what initialisation actually 
means. 


Name Length Limit 


Clipper has a 10 significant characters 
name limit on functions, and hence 
classes and their message names. This 
proves to be a severe limitation as your 
classes and inheritance relationships 
get more complex. 


You cn rsrt 2 a vowel-less C++ style of 
naming convention, but I don’t favour 
this: I much prefer to see Sorted- 
Collection instead of 
SrtdClictn, asI can type the former 
just as quickly. Furthermore, current 
Clipper naming conventions tend to be 
more like the equivalent English words. 


Object Message Syntax 


I find the syntax of object-based ex- 
pressions quite difficult to read, espe- 
cially when methods receive multiple 
arguments. 


For example, take a dictionary class 
that allows you to associate unique 
character keys with corresponding val- 
ues. You would probably have a 
method that allowed you to remove 
keys as well as add them. It would 
seem sensible to call this message re- 
moveKey so you would send the mes- 
sage like this :- 


oDict : removeKey ("expenses") 


However, what should happen if there 
are no expenses? Do you generate an 
error or simply ignore the situation? 
These issues should be addressed by 
the programmer who may decided to 
add an optional argument so the mes- 
sage may be sent thus :- 


oDict : removeKey ("expenses", ; 
{ || alert ("no expenses") }) 


The functional style message syntax is 
at odds with the concept of sending 
messages to objects. When you start 
nesting expressions of this nature, it’s 
easy to get really confused with all 
those brackets, colons and commas 
flying around. 


The Key Benefits 


Before we go into the detail, let’s have 
a look at the key benefits of applying 
the techniques I’m about to describe. 


@ Message errors found during com- 
pilation instead of run-time. 

@ Easier to see what types of objects 
are being dealt with. 

@ Consistent object initialisation. 

@ More formal genericity. 

@ Can be used as a basis for class 
documentation. 

@ Easier to support long class and 
message names. 

@ Multiple-argument messages can be 
split using keywords for each argu- 
ment. 

@ Easy way to support selective in- 
heritance and message renaming. 

@ It doesn’t look like Clipper code. 


Because I’m such an honest chap, I'll 
also mention what may be viewed as 
the bad points :- 


@ Code is more verbose. 


local list is Array 
Array list add "oranges" 
Array list eval ; 
{ | item | qout(item)} ; 
startingAt 3 forNext 10 


Figure 2 - 
Treating Arrays as Objects 


Mode of Transport 


Automobile 


Figure 3 - Inheritance Diagram 


@ Requires careful management of 
header files. 

@ It doesn’t look like Clipper code, if 
you like the look of Clipper code. 


How Does It Work? 


My main ally is the pre-processor, in 
that for every class there are a serious 
of #xtranslate directives, one for 
each message supported. Figure 1 
shows the some of the directives I use 
for my basic Dictionary class. It 
should be fairly easy to see how the 
alternative syntax gets mapped back to 
standard Clipper style. Going back to 
the previous example I can now write 
the following expression :- 


Dictionary oDict ; 
removeKkey "expenses" ; 
ifAbsent ; 

{|| alert ("no expenses") } 


Since I use #xt ranslate I can build 
complex nested expressions and enjoy 
the freedom of longer keywords. This 
is a departure from a command ori- 
ented approach used in some third- 
party object-based libraries, while 
combining the readability of prefixing 
arguments with keywords. It’s also 
easier to see what’s going on as all 
object references are prefixed with 
their type. To my mind this makes the 


function hubCapCost (auto) 
local result is Numeric 
if Automobile auto ; 
isDescendantOf Automobile 
result := Automobile ; 
auto numWheels * ; 
Automobile ; 
auto pricePerHubCap 
else 
// handle error 
endif 
return (result) 


Figure 4 - Hubcap Cost Routine 


same sense as writing len (aNum- 
bers) so the reader can tell that you 
are dealing with an array rather than a 
string. In the polymorphic weakly- 
typed world of Clipper, I think this is 
even more important. 


This syntax will be instantly recog- 
nised by anyone who has used the 
Smalltalk language, which is the origin 
of my idea. 


You cn rsri2a 

vowel-less C++ 

style of naming 

convention, but 

I don't favour 
this 


Compiler Errors 


Using this technique, any unsupported 
message will generate a syntax error. 
This error will either pin-point the 
name of the object to which an unsup- 
ported message is being sent, or the 
name of a misspelt message. Either 
way, I find this gets me straight to the 
offending code, although you do need 
to do several compilations if there is 
more than one error in a statement. 


Object Initialisation 


Also included is the provision for im- 
mediate object initialisation when vari- 
ables are declared, so you can write 
local myDict is Dictionary 
instead of local myDict := Dic- 
tionary () :new(). 


This does raise the question of what a 
class constructor should actually do. 
Opinions differ, but I’ve found the 
following simple guidelines provide 
reliable and reusable classes. 


@ Initialise instance variables to the 
correct type and state. 

@ Avoid calling other methods unless 
they do the above. 

@ Don’t use constructor arguments. 


Expanding on this, it is important to 
understand the notion of the type and 
state of an instance variable. For exam- 
ple, a flag used in a file class may 


OOP with Clipper 


indicate if the file is open or not, 
therefore its type is logical and its state 
is false. A more complex class may use 
an error log file, in which case I would 
tend to argue that the constructor 
should open the error file, as an in- 
stance may be useless without it. 


The second point is the exception to 
the rule in cases where you may want 
to export the process of initialising 
certain instance variables, for example, 
the initial balance of a bank account. 
The important thing to remember here, 
is that for any method you decide to 
export, make sure you use it in the 
class itself if you need that particular 
service. 


The third point may draw criticism, but 
this was originated from the way in 
which some OOP extensions pass con- 
structor arguments back to the super- 
class. I don’t think this is such a good 
idea as the number and types of argu- 
ments could easily differ in a subclass. 
The general rule of thumb is the sim- 
pler the constructor, the better. 


Arrays As Objects 


I have found that initialising all data 
types, including objects, in this way 
reduces errors and promotes consis- 
tency and clarity in source code, espe- 
cially in programming teams. It also 
allows you to treat arrays as objects 
without having to write an object 
wrapper. This can make complex array 
handling more readable as in Figure 2. 


More Formal Genericity 


The techniques presented here allow 
generic programming, but in a more 
object-oriented way. For example, 
consider the class structure shown in 
Figure 3. 


Suppose I’m writing a generic routine 
to calculate the cost of replacing hub- 
caps for cars, vans and lorries. If I’m 
writing a method (or function) to do 
this, I can say that the type of object 
should be a descendant of Automo- 


method accCompare (acc) 
local result is Logical 
if BankAccount acc ; 
isKindOf BankAccount 
result := 7 
self:accNum == acc:accNum 
else 
// handle error 
return (result) 


Figure 5 - 
Account Compare Routine 
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bile. So I can write the routine as 
shown in Figure 4. This routine is quite 
safe in that it will handle any future 
descendant of that class. This makes it 
very clear, in quite a formal way, just 
how generic the routine actually is. 


If you need run-time type-checking, 
which is advisable in Clipper, it is fairly 
easy to implement an isDescend- 
antOf message so you can still type- 
check generic code. 


You can also support something like 
operator overloading, so you can write 
if BankAccount accOne == 
BankAccount accTwo self. The 
comparison may be simply done on 
the account number. So, by using a 
directive in the header file #xt rans- 
late BankAccount <acc> == 
<accl> => <acc>:accCom- 
pare (<accl>) you can emulate op- 
erator overloading. Example code for 
the accCompare method is shown in 
Figure 5. 


Docs & Headers 


How to document these new classes? 
Well, if you strip out the #xtrans- 


late and the actual translations, and 
add comments on functionality and 
return values, you can end up with a 
reasonable documentation of the class 
interface. The downside is that you do 
end up having to duplicate the parent’s 
class directives, although I’ve found in 
practice that you often need to make 
subtle alterations to comments and 
message argument types anyway. 


To #include every class header file 
in every client module would be a bit 
if a nightmare! To counter this, I split 
classes into groups based on their in- 
heritance relationships and #in- 
clude all these files in a new version 
of the STD.CH header file. Then, if 
you're using classes, simply compile 
with the /U option. 


Conclusion 


Overall, I like using this style of cod- 
ing. Even though you type more, I’ve 
found that it doesn’t seem to take any 
longer to write code, in fact, the syntax 
follows the way you might think about 
what you need to do. As an added 
bonus, many potential errors and prob- 
lems are reduced either because of the 


Clipper 


compiler syntax or simply because the 
code is more readable. 


Furthermore, many of the techniques 
suggested here provide an insulating 
layer between add-on or language 
specific details. This will give rise to an 
even smoother migration path to a 
fully object-oriented version of Clip- 
per, Aspen, and even other OOPLs. 


ex) 


Rob Jackson is a Senior Clipper Ana- 
lyst/Programmer and Registered OOP 
Addict whose lifetime ambition is to 
write articles for .EXE Magazine (poor 
fool! - Ed). He has been programming 
in xBase/Clipper for over 5 years, and 
using OOP techniques for almost 2 
years. He has spoken at several Clipper 
User-Group meetings around the coun- 
try, mainly on the subject of OOP. He 
may be contacted via CompuServe on 
100063, 2602. 

SuperClass and Class(y) are the two 
leading Clipper add-ons that provide 
Clipper 5 with OOP extensions. They 
are priced between around £50 and 
£250, depending on which variant you 
require, and are available from dealers. 


we The Hard wa 
Option? 


> EVERKEY Il 


Not available in ANY other Key product. 


~ EVERLOCK 


Option? 


~ EVERTRAK 


Option? 


Sole Distributor for Az-Tech Software,inc 
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SINGLE WIRE ZERO LOAD - Total Compatibility. 


mn The Soft ware 


Software-Only Copy Protection; economical & SECURE. 


wa Non Copy- Protection 


Non Copy-Protection - Anti Hacker software protection. 


CALL FOR A FREE WORKING DEMO DISKETTE 


- UK, Ireland & Spain. 


LOOK at all OPTIONS. 


Software Protection - a which TYPE ? 
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croSystems 
Lr Bartleet Road, 
Washford Industrial Estate, 
Redditch, Worcestershire, 
B98 ODG. England. 
Tel: 0527 510 105 
Fax: 0527 514 229 


What’s so Special 
about Salford Fortran? 


A compiler is a compiler is a compiler - 
tight? Wrong! If you write programs for a 
living, you probably use your compiler 20 times a 
day, and a poor compiler wastes your time and your 
company’s money every time. Slow compilation, silly 
restrictions, poor diagnostics and downright bugs - these 
are the rule, but the exception is Salford FTN77. FTN77 
is highly stable and has the best diagnostics in the 
business. It compiles 6 or 7 times faster than the 
big-name competition, but produces smaller objects and 
faster executables. 


But it’s not just the absence of vices that makes FTN77 
so good. There are dozens of features you won't find in 
lesser products, like virtual memory support, an 
integrated debugger and profiler, in-line assembler and a 
Windows development library. The /UNDEF switch, 
unique to Salford compilers, will regularly save hours of 
debugging by spotting the use of undefined memory 
areas at run-time. 


Don’t skimp on the tools of your trade, buy the best - 
Salford FTN77/486. 


Also available with full support from Polyhedron are Fortran 90, C++ and Pascal 
compilers from the same stable. 


Polyhedron Software Ltd. 
Terie 93 High Stet, Tol 0865-s00570 Pollylnediron 
Sofiiware 


Standlake, WITNEY, OX8 7RH 
United Kingdom Compuserve 100013 1 
US TOLL-FREE FAX'1-800-777-5519 


Free 
Software 


- Yours! 


without 


CopyControl 


The ultimate Copy Protection System 


° User friendly & secure 

° Beats all bit copiers & disassemblers 

° Supports networks, backups, disk caches, windows etc. 

® Remote changing of parameters 

® No add-on hardware or special disks required 

* Control where, when & how often your programs are run 
° Compatible with all IBM MSDOS compatible computers 


For more information contact 


MICROCOSM LIMITED 


17 Cranbrook Road, Bristol, BS6 7BL, UK 
Tel: (0272) 441230 Fax: (0272) 427295 


> CIRCLE NO. 936 


(| 2 Co lactate || 


CA-CLIPPER 5.28 
TRAINING PROGRAMME 


Our successful Clipper training programme has 
been fully revised for the new release. Practical 
courses using many example applications have 
been designed to meet the varied needs of Clipper 
users. 


CA-Clipper 5.2 
Foundation & Skills I - 3 days 


The optional Foundation day is for programmers new 
to XBase languages. It provides a full summary of 
Clipper features and the wider development 
environment, including add-in products and systems 
development considerations. 


The Skills | course, for new users, is an intensive and 
thorough introduction to Clipper programming. 
Through case studies and exercises all delegates will 
be able to apply the theory to practical programming 
examples. 


CA-Clipper 5.2 Skills II - 2 days 


Intermediate training which addresses the more 
advanced features of Clipper 5.2 and concentrates 
on those parts of the language which have the 
greater impact on productivity. Delegates will learn to: 


make effective use of a wider range of Clipper 5.2 
features 


© apply improved debugging and diagnostic techniques 
apply advanced programming techniques 
1 develop better quality applications more quickly 


CA-Clipper 5.2 Networking - 1 day 


An intensive day examining networking and 
multi-user programming in Clipper. The course is built 
around a practical case study application running 
under Novell Netware 2.2. The course also includes 
an examination of network functions & library add-ins. 


All courses are available at least once a month at our 
London training centre and also on client site. For full 
course outlines, prices and course reservations... 


Call 071 © 922 ©8819 


Richfords also provide training in: 


MICROSOFT & BORLAND 
PROGRAMMING TOOLS 
RICHFORDS 
el South Bank Technopark . 90 London Road 
A LONDON SE1 GLN. Fax 077.922 . 8820 
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DMA 


The Secrets of DMA 


In the final part of bis DMA epic, Benjamin Sidle ties up his loose ends, and deals with the 
special considerations of PS/2 and EISA machines. 


Previously in IC: I have explained the 
workings of the 8237 chip, and how 
these apply to the PC. I have also 
presented skeleton code for transfer- 
ring data using the 8237. This month, 
I will deal with DMA on the more 
modern PC architectures. But first I 
must settle a problem familiar to PC 
programmers: that of crossing the 64 
KB boundary. You may wish to have 
.EXE's May and June issues to hand, as 
I shall be referring back to figures. 


Crossing the Boundary 


The 8-bit DMA chip cannot transfer 
data across a 64 KB boundary. But 
what if the data you want to download 
is greater in size than 64 KB? Or it just 
so happens that your buffer starts so 
far up the page that it is forced to cross 
the boundary? 


There are two approaches to this prob- 
lem. You could calculate ahead before 
you even begin a transfer and see if 
your transfer will cross a boundary; if 
so, you divide the transfer into sections 
about the boundary. The first transfer 
will fill the buffer right up to the 
boundary, then you increase the page 
address by one and reload the new 


you are using, with zero (as you are 
now starting at the beginning of a 
page) and reload the count register 
with the number of points left to trans- 
fer (don’t forget to subtract ‘2’). This is 
the approach taken in the program 
provided (see Figure 2). 


However, this first method could cause 
problems if the rate at which data 
arrives is so fast that any temporary 
buffers used to store data are overrun 
while the various DMA registers are 
reprogrammed. There is a way round 
this providing your proposed data 
transfer is 64 KB or less. If you allocate 
twice as much memory as you need 
and then calculate where, if at all, the 
buffer crosses page boundary(s), one 
part of the buffer will always be big 
enough to accommodate your transfer 
without having to cross a page bound- 
ary. This method sacrifices memory in 
favour of speed. 


Another way to improve speed would 
be to use two DMA channels so that 
you do not have to keep programming 
a single DMA channel to accommodate 
the two buffers (BUFFER1 and BUFF- 
ER2). Ona 286 or greater system, DMA 
Channel 0 could be assigned to BUFF - 


Page Register. You also load the Base | ER1 and DMA Channel 1 to BUFFER2. 
Address Register, for whatever channel | Both channels would then be pro- 
= _ - grammed into auto- 
Function Name Program Command Bits Used initialisation mode 
so as they retained 
W/O Address Register 0h 0-15 their Base Address 
Memory Address Register Write 2h 0-23 and Base Count in 
; between transfers. 
Memory Address Register Read 3h 0-23 However this would 
Count Register Write 4h 0-15 also strongly depend 
Count Register Read 8h 0-45 on the design of the 
adapter board you 
Status Register Read 6h 0-7 were programming 
Mode Register 7h 07 and whether it al- 
lows the selection of 
Arbiter Register 8h 0-7 2. active DMA Chan- 
Mask Register Set Single Bell 9h nels. 
Mask Register Reset Single Bell Ah 
Master Clear Dh PS/ 2 


Figure 9 - Table of Extended Mode Commands 
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There are some extra 
considerations in us- 
ing DMA on PS/2’s 


with their Micro Channel Architecture 
bus. For a start, channel 4 is free for 
DMA transfer and uses the page regis- 
ter at port 8FH. There are two ways of 
programming the DMA subsystem on 
the PS/2’s 8237 compatible mode and 
Extended Mode. Compatible mode is 
nearly identical with that on the 
PC/AT: all the ports for the DMA chips 
and Page Registers are at the same 
location. The differences are that the 
Flip-Flop, Master Clear and Clear Mask 
Register are no longer available. The 
Base Address and Base Count Regis- 
ters are written in a single 16-bit action. 


In Extended mode there are two extra 
Registers which allow access to the 
extra modes available on the PS/2, as 
well as allowing all the conventional 
functions to be programmed in 
through these extra Registers. The first 
of these two Extended Mode Registers 
is the Function Register at Port 18h. 
This register allows you to specify the 
target DMA channel and the function 
to be programmed. 


Bits 0-2 - Channel Number. 
Bit 3 - Unused. 

Bits 4-7 - Specify the function 
(see Figure 9). 


If a function requires associated data 
to be written to the port, this is 
achieved by writing to the Extended 
Function Execution Register located at 
Port 1Ah. The DMA chip can be en- 
tirely programmed from these two 
Registers. When reading or writing to 
the Memory Transfer Registers, the ad- 
dresses are 24-bit, as the Page Registers 
are written as well. This single write is 
accomplished by using the EAX Regis- 
ter. In extended mode there are some 
extra registers available; the I/O Ad- 
dress Register allows the target I/O 
Port to be programmed in. The Arbiter 
Register allows the Arbitration level of 
channels 0 and 4 to be changed. The 
arbitration level of the other DMA 
channels are fixed, with their level 
being the same as their channel num- 
ber (initially Channels 0 and 4 are set 


ting temporary | 
y file, please wait. 


How much longer can you afford to wait? 


Create Overlaid Programs-Fast. 
BLINKER", the world's first and 
fastest dynamic overlay linker, 
reduces your link time to seconds 
and reduces program memory 
requirements. Now you can use 
one linker for all your software 
projects. 


One Linker, Many Languages. 
BLINKER 2.0 links and automati- 
cally overlays DOS programs 
written in Microsoft?C, BASIC, 
Assembler, QuickBASIC”, 
Fortran, Pascal, Watcom”™ C, 
Zortech C++, Clipper, FORCE® 
and in Borland? C, C++, 
Assembler, and more. 


Save Time and Memory. 
BLINKER removes the need for 
overlay structures, simplifies 
program design and reduces 
memory requirements to save 
you time, effort and memory. 


Memory Swap Function. 
BLINKER is the ONLY linker. to 
offer an integrated memory swap 
function, so you can run other 
large programs from within your 
program, with negligible memory 
overhead. 
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High Performance Oynarnic Overlay Linker 


Don't Settle for Less. 


Other major features include full 
CodeView’ support, use of 
EMS/XMS at program run-time, 
and enhanced execution speed 
of overlaid code. 


Time is Money. 
BLINKER offers all this in a frac- 


tion of the time it takes to link 
with your current overlay linker. 
You know time is money, and link 
time is no exception. 

To try our free demo re | 
on your own code ! 

and for more information 

contact our U.K. distributor: 


Call: +44-81-994-4842 
FAX: +44-81-994-3441 


QBS Software Ltd. 
10, Barley Mow Passage 


Free Demo 


London W4 4PH 
BLINKER is A > 
available in : a 
5.25" or 3.5" 3 Sigs af 
diskette format ew 
Price £229 Blinkinc 
plus shipping & handling P.O Box 9 

; Penarth, Sth Glam 
zs) (SO). Gwent CF6 2XF 

UK. 


© 199} Blinkinc. Blinker is a traclernark of Assembler Software Manufacturers Inc. 
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to Arbitration levels 0 and 4 respec- 
tively). Channels 0 and 4 can be pro- 
grammed to any arbitration level, 
except of course OFh, which is that of 
the microprocessor. 


The bits of the mode register are rede- 
fined in extended mode as follows:- 


Bits 7, 5, 4 and 1 are reserved and 
must be set to ‘0’. 

Bit 6 - When set to ‘0’ allows 8-bit 
transfers, and when set to 1 allows 
16-bit transfers. 

Bit 3 - 0 for a Read from Memory and 
1 for a Write to Memory. 

Bit 2 - 0 for a Verify and 1 for a Data 
Transfer. 

Bit 0 - 1 use Programmed I/O address, 
0 set I/O address to 0000h. 


ISA 


On ISA machines there is a new set of 
page registers known as the Upper 
Page Registers (the conventional Page 
Registers are rebadged as the ‘Lower 
Page Registers’). These new Page Reg- 
isters are four bits long, and allow up 
to 256 MB to be addressed. The Upper 
Page Register for Channel 0 is located 
at port 0487h ie the Port number of the 
(Lower) Page Register plus a 1000 
(0400h). The other Upper Page Regis- 
ters are similarly located. The Lower 
Page Register must be written to first, 
as writing to it sets the Upper Page 
Register to zero. 


EISA 


For the EISA bus these Upper Page 
Registers are eight bits long allowing 
access to 4 GB of address space. Their 
port location is the same as for the ISA 
systems. 


On the EISA system the DMA channels 


are part of the 82357 Integrated System 
Peripheral (ISP) chip and, although 
Channel Bits 7-2 | Bits 15:8 | Bits 23-16 
Number ; 
0 04E0h O4Eth 04E2h 
1 O4E4h O4E6h O4E6h 
2 04E8h O4E9h O4EAh 
3 O4ECh O4EDh O4EEh 
i) O4F4h O4F5h 04F6h 
6 O4F8h 04F9h O4FAh 
7 04FCh O4FDh. O4FEh 


Figure 10 - Table of Stop 
Registers’ Locations 
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compatible with the 8237, there are 
some extra registers and facilities avail- 
able. Channel 4 is still unavailable, 
being in cascade mode, but the other 
channels can be programmed for 8,16 
and 32-bit mode. The count registers 
are 24 bits long. The first 16 bits are 
programmed via the usual count reg- 
isters with the use of the Flip-Flop 
Register. Programming the lower 16 
bits sets the upper 8 bits to zero, so 
they must be programmed second. 
The Upper Count Registers are located 
by adding 0400h to the corresponding 
16-bit Count Register. There are also 
two Extended Mode Registers, one for 
channel 0-3 located at port 040Bh and 
one for channels 4-7 located at port 
04D6h. The bit pattern of the Extended 
Mode Register is as follows: 


Bits 1 and 0 determine the channel (00) 
corresponding to channel 0 or 5 etc. 


Bits 3 and 2 define the transfer size: 
(00) - 8 bit transfer count by bytes, (01) 
- 16-bit count by word with the address 
shifted as discussed for channels 5,6 
and 7 on the 8237. (10) - 32 bit transfer 
count by bytes. (11) - 16 bit transfer 
count by bytes. For this selection the 
address can be programmed in the 
conventional way aligned on an odd 
boundary if so desired. This will cause 
a partial transfer on the first and last 
transfer. 


Bits 5 and 4 determine the speed of 
data transfer: 


(00) - Compatible Timing, this is the 
slowest transfer available and is pro- 
vided for DMA devices not capable of 
the faster speeds available. 


(01) - Type ‘A’ Timing. This is for faster 
transfers using EISA memory. For 8/16 
bit ISA Memory the timing will auto- 
matically revert back to Compatible 
Timing rates on a cycle by cycle basis. 
Many ISA DMA devices are able to use 
this Type ‘A’ Timing Cif used with EISA 
memory). 


(10) - Type ‘B’ Timing. This is for even 
faster transfers for 8/16 bit ISA or EISA 
DMA I/O devices that can work at very 
high I/O rates. This timing only works 
with EISA memory. Should ISA mem- 
ory be used the timing reverts back to 
Compatible Timing on a cycle by cycle 
basis. A number of the more recent ISA 
DMA devices are able to use this Type 
‘B’ Timing. 


(11) - Type ‘C’ Timing (Burst Timing). 
This the fastest timing of all and is for 


DMA 


use by EISA DMA devices using EISA 
memory. Up to 33 MB per second can 
be achieved using 32-bit memory. This 
timing mode is also available for 8 and 
16-bit EISA DMA devices. 


Bit 6 - End of Progress (EOP) Selec- 
tion. This decides whether the EOP is 
to be used as an input(1) or output(0) 
signal during DMA transfer and has 
been added to allow data communica- 
tion. If used as an input it allows a 
device to trigger an auto-initialisation 
when a given condition occurs. 


Bit 7 - This determines if the Stop 
Register associated with the Channel is 
to be used(1) or not(0) 


Stop Register 


Each channel has associated with it a 
22-bit Stop Register for use with a com- 
mon data communication structure 
known as a Ring Buffer. This facility is 
only of use when the channel has been 
programmed in auto-initialisation 
Mode. The Ring Buffer is located on 
Double Word boundaries. The limits 
of this Ring Buffer are defined by the 
Base Address and the Base Address + 
Base Count Register (in bytes). 


When a DMA transfer has finished, the 
auto-initialisation takes place and the 
DMA is ready to use the same area of 
memory again. However by now the 
Processor will have started to transfer 
data out of the Ring Buffer. It keeps 
track of where it has got up to in the 
Ring Buffer by writing to the Stop 
Register. When a double word is read 
by the processor from the Ring Buffer, 
that location becomes available for 
further DMA transfers. (NB although 
the Stop Register operates in double 
words, one can still perform DMA one 
byte at a time.) 


When the DMA starts to transfer again, 
it cannot transfer above the value in 
the Stop Register. Should the DMA 
transfer reach the Stop Register, it will 
transfer into the memory location de- 
fined by the Stop Register, after which 
the Channel will be masked off. 


The 22 bits used are defined on Ad- 
dress lines A23 - A2, so the maximum 
size of a Ring Buffer is 16 MB. Each of 
these 22-bit registers is accessed by 
writing to three consecutive ports (the 
starting port for each Channel is given 
in Figure 10). For the first port of each 
Channel only bits 7-2 are used; the 
contents of bits 1 and 0 are ignored. 


Half the cost 
NOT 
half the dongle 


Softlok Il Keys, developed by Softlok International, 
have been designed to be an effective yet low cost 
solution to software piracy. Designed and 
manufactured in the UK for software developers 
worldwide, Softlok Il contains all the flexibility you 
will need to protect your software. 


Softlok II units are sophisticated keys containing 
240 bytes of secure non volatile memory. An 8 
byte password provides read/write protection. Both 
the memory area and password can be changed 
using the supplied routines from your application. 
As aprogramming adaptor is not required, they 
can also be altered in the field. 


Our low cost starter pack contains everything you 
need to get you quickly up and running with 
routines provided on the disk for most DOS and 
Windows compilers. We can usually ship Softlokll 
Keys for next day delivery so that you can get your 
software on the market just as quick. 


All prices exclude VAT and delivery 
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Chaining Registers 


The final DMA EISA feature to be 
discussed is very useful; it allows you 
to transfer to or from multiple memory 
buffers. It makes use of the fact that 
the Page, Address and Count Registers 
have a Current Register and a Base 
Register (which is what allows auto-in- 
itialisation). They are both pro- 
grammed simultaneously with the 
same value when used in the standard 
fashion. It should be noted that the 
Page Registers are located on the 
82357 ISP and have both a Base and 
Current Register (unlike on XT, AT and 
ISA buses where the Page Registers 
only have a Current part). There are 
also two Set Chaining Mode Registers 
both of which are write-only. One 
handles Channels 0-3 at port 040Ah, 
the other, channels 4-7 at port 040Dh. 
The bit pattern is as follows: 

Bits 1 and 0 determine the channel (00) 
corresponding to channel 0 or 5 etc. 
Bit 2 - Disable (0) or Enable Chaining 
Mode. 

Bit 3 - Programming Complete (1) or 
Don’t Start Chaining (0). 

Bit 4 - Generate IRQ 13 (0) or Generate 
TC (1). 

Bits 5-7 - Reserved 


The first step is to disable the chaining 
mode for the particular channel you 


;MODEL LARGE 


Program to demonstrate use of Chaining 
Buffers using Terminal Count to indicate 


end of a particular transfer. 


Chain Reg. for Channels 0-3 
CHAIN_MODE_REG EQU  040Ah 
STATUS EQU 08h 
MODE EQU OBh 


;Byte Transfer, Add. Inc, Chan. 1 


CH1_MODE_VALUE EQU  01000101B 
STATUS_VALUE EQU 000000108 
;Disable Chaining for Channel 

NO_CHAIN_SET EQU 00010001B 


+Enable Chaining for Channel 1 
ENABLE_CHAIN EQU 000101018 
;Programming Complete 


CHAIN_COMPLETE EQU  00011101B 


.CODE 
PUBLIC CHAIN 
EXTRN LOAD_REG: PROC 
CHAIN PROC FAR 
MOV AL, CH1_MODE_VALUE ;Prepare for 
mode 
ouT MODE, AL yand send it 
Mov 
MOV 
our 
ing 


AL,NO_CHAIN_SET 
DX, CHAIN_MODE_REG 
DX, AL ;Disable Chain- 


; Set up the initial set of Page, Base Address 
+ and Base Count Registers. 


MOV 
MOV 
Mov 
CALL 


AX, First_Address 
BX, First_Page 
Cx, First_Count 
LOAD_REG 


MOV AL, ENABLE_CHAIN 


are going to use and program the Page, 
Address and Count Registers in the 
usual way. This will set both the Base 
and Current Registers for these func- 
tions. Next, the chaining mode is en- 
abled and the second set of Page, 
Address and Count Registers are writ- 
ten in the usual way. However, this 
time only the Base Registers are af- 
fected. When this has been done, the 
Chaining Mode Register is set for en- 
able chaining and programming com- 
plete. As things stand now the Current 
Registers have the ‘First’ set of values 
in them and the Base Registers have 
the ‘Second’ set of values in them. 


The DMA transfer may now start. When 
it has reached its terminal count the 
‘Second’ set of values stored in the 
Base Registers are automatically moved 
to the Current Registers, the Enable 
Chaining and Programming Complete 
bits are reset, and the DMA continues. 
While the second part of the DMA 
transfer is in progress, the ‘Third’ set of 
values are programmed into the Base 
Registers, and the enable chaining bit 
and programming complete bits are set 
again, 


If the second part of the DMA transfer 
should reach Terminal Count before 
the Programming complete bit is set, 
an overrun will probably occur. In this 


MOV DX, CHAIN_MODE_! 
OUT DX, AL 


;Enable Chaining 


+ Now program in next set of Page, Base 
; Address and Base Count Registers. 

} These will not be used until the first 
+ set have been finished with. 


MOV AX, Second_Address 
BX, Second_Page 
CX, Second_Count 
LOAD_REG 


MOV AL, CHAIN_COMPLETE 
MOV DX, CHAIN_MODE_REG 
OUT DX, AL 


START DMA CODE GOES HERE 


DMA_TEST: 
IN AL, STATUS 
TEST AL, STATUS_VALUE 
a2 DMA_TEST 


7 At this point the ‘Second’ values in the 
; Base Addresses are moved into the Current 
; Registers. While the DMA is ongoing the 

; 'Third’ values are programmed into the Base 
; Registers. If Terminal Count is reached 

; before the Program Complete Bit is set then 
# an over-run will occur (see Text). 


MOV 
MOV 
MOV 
CALL 


AX, Third_Address 
hird_Page 


CX, Third_count 
LOAD_REG 


Mov 
Mov 
our 


f Btey 
RET 


CHAIN ENDP 
END 


Figure 11 - Code for use of Chaining Buffers 


84 .EXE Magazine, Vol 8, Issue 2, July 1993 


DMA 


case, the Terminal Count bit of the 
Status Register and the Channel’s Mask 
bit will be set. The Mask bit can be 
checked by reading the Mask Register 
- OFh for channels 0-3 (which is read- 
able on the EISA bus). To avoid over- 
run, the transfer type should be set to 
single byte or demand transfer, as 
these give time for the next set of 
values to be programmed into the Base 
Registers. In Block Mode there would 
probably never be enough time, as the 
processor is locked out for the dura- 
tion of the transfer. If an overrun does 
occur then the Page, Current, Count 
and Chaining mode must be repro- 
grammed. Figure 11 shows how to set 
up DMA Channel 1 for Chaining. 


The signal generated when a transfer 
has reached its Terminal Count de- 
pends on where the new programming 
information for the various Base Reg- 
ister is to come from. If the information 
is to come from the host CPU, then bit 
4 of the Chaining Mode is cleared, 
which means that an IRQ 13 will be 
generated. If the information is to come 
from an EISA master then the bit 4 is 
set to 1, causing a TC signal to be 
generated, 


There are three other read-only regis- 
ters concerned with chaining, in each 
case the bit number corresponds to the 
channel. The first of these registers is 
the Set Chaining Mode Status Register 
at port 04D4h. This shows which 
Channels have Chaining Mode en- 
abled (=1). The bits are set via bit 2 of 
the Set Chaining Mode Register. 


The Channel Interrupt Status Register, 
located at port 040Ah, indicates which 
Channel is the source of a DMA chain- 
ing interrupt on IRQ 13. The final 
register (pant, gasp!) is the Chain Buff- 
er Expiration Control Register located 
at port 040Ch. This register shows what 
the result will be when a buffer is full: 
0 for IRQ 13 and 1 for Terminal Count. 


Conclusion 


DMA is not for the faint-hearted - but 
neither is it hopelessly difficult, as 
some of the Standard Works on PCs 
imply. I trust these articles have shed 
some light and inspired some ideas on 
area of computing which has been 
neglected in the literature for too long. 
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UNIX 


Networked File Systems 


... or Why we aren't still using PIP for everything. Non CP/M fan Peter Collinson explains 
the evolution and workings of RFS and its popular rival NFS. 


It’s always interesting to speculate what 
might have happened had UNIX not 
been invented. It’s certainly had a huge 
influence on the development of com- 
puting. I am fond of saying that all the 
good bits in MS-DOS were taken from 
UNIX and all the bad bits from CP/M. 
This is supposed to be a joke and is 
not intended to provoke the operating 
system zealots amongst you to start 
dispatching rude letters to the Editor. 


I do think that UNIX proved that the 
hierarchical file system was the way 
that disks should be handled. In the 
late 1970s, the notion that files are 
stored in a tree of directories was revo- 
lutionary. 


When networking started to happen in 
the 1980s, there were many attempts 
to join machines together in a coherent 
way. Most of the systems copy a single 
file from machine A to machine B. 
There are now a great many programs 
and suites that do this for UNIX and 
other operating systems: UUCP, the 
UK’s NIFTP, the Internet protocol FTP, 
the ISO FTAM, and the rcp program. 


Moving files like this suffers from sev- 
eral problems. First, you are copying a 
file, so which file is now the master 
copy? To keep things consistent, you 
have to keep track of the machine 
where you made the last change to the 
file and you have to ensure that all 
other copies are updated with the new 
contents, Second, it’s hard to move the 
file ‘context’. A file lives in a directory, 
is owned by a particular user, has a set 
of access permissions etc. If the file is 
program source, then it can refer to 
other files on the machine. When you 
move the file, you will have to move 
all these other files too. Finally, there 
may not be space on the destination 
machine to store the file. 


A solution was needed. Several people 
realised that UNIX already contained 
the answer. When you add a new disk 
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onto a UNIX system, you connect the 
file system living on that disk to the 
existent file tree by mounting. You tell 
the kernel that root directory on the 
new disk is mounted ‘on top’ of some 
other directory in the file system. The 
directory ‘underneath’ disappears and 
is replaced by the top of a new sub- 
tree. Effectively, you add a new branch 
to the file system tree in a seamlessly. 


Remote 
Procdure Call is 
the key to 
networked file 

systems — 


The kernel arranges that the mount 
point is invisible. When you use a 
pathname to the files on the mounted 
disk, the kernel notices the mount 
point and starts to access files on the 
new disk. 


The designers of MS-DOS decided not 
to adopt the single tree policy. Instead, 
there is a forest (or perhaps a copse) 
where each file system contains a 
separate tree. There are good reasons 
for this. The UNIX mount method 
means that the kernel has to retain 
state about its mounted file systems to 
manage the seamless transition from 
one disk to another. To pull a mounted 
floppy from a machine you have to 
remember to dismount the file system 
first. UNIX aficionados say ‘unmount’ 
after the command name that does 
this. The kernel may be storing some 
state for the floppy and so the file 
system on the media may be inconsis- 
tent. It’s also likely that you will trash 
the next floppy that you put into the 
drive. Sun forces you to ‘remember’ by 
not giving you a physical eject button. 


OK then. UNIX came ready made with 
the notion that new file systems would 
be mounted to grow the existing tree. 
The simple answer to the problems of 
file sharing over several machines was 
to provide access to remote files by 
mounting the file system on which 
they live. This joins the remote file 
system to the local machine as if you 
were mounting a disk and gets over all 
the problems of file copying. 


UNIX United 


The idea of joining file systems like this 
occurred in several places. The notion 
seems so obvious now, it’s hard to 
remember that there was a time when 
it didn’t exist. I was first exposed to a 
network file system when I was invited 
to a meeting at the University of New- 
castle in the early ’80s. Lindsey Mar- 
shall had joined the file systems of a 
set of Version 6 UNIX machines form- 
ing a networked ‘single’ machine that 
was called ‘UNIX United’. 


The network technology that was used 
was the Cambridge Ring and inciden- 
tally the code used a device driver that 
I had written for our own use at Kent. 
The Cambridge Ring was used in sev- 
eral UK universities at a time when it 
seemed that fast networking was a 
must and other technologies were not 
available. 


Lindsey implemented UNIX United in 
an interesting way. He replaced the C 
library for the standard system calls by 
his own code. Then, by re-compiling 
a program, the new binary would have 
the ability to access files over the net- 
work. The library code knew whether 
a file was local or remote. It switched 
calls for the local file system into the 
local kernel. For a remote file, it par- 
celled up the procedure call parame- 
ters into a message that was sent to a 
server on the remote machine. The 
server executed the call and returned 
a response to the calling machine. The 


response was passed back to the pro- 
gram as if the normal system call had 
just returned. Doing all the work in 
user space was an expediency. It meant 
that he could develop things on ma- 
chines that were providing service to 
others. Later versions of UNIX United 
moved the calling code into the kernel, 
where it lurked just below the system 
call layer. 


The idea that you take a procedure 
call, pack the parameters into a mes- 
sage, send it somewhere and wait for 
a reply is called Remote Procedure Call 
or RPC. The benefit is that you can take 
an existing program written for a set of 
routine interfaces and execute it using 
resources elsewhere. RPC is the key to 
all the various networked file systems. 


Lindsey’s approach worked well. Lind- 
sey was helped because he was oper- 
ating with a set of homogeneous ma- 
chines. He didn’t have to worry about 
byte ordering, the length of words and 
character sets. He was operating be- 
tween UNIX systems, so he could put 
the standard system call interface into 
an RPC message. He didn’t have to 
worry about implementing server code 
that would translate the UNIX system 
call layer into some other set of calls 
for a different operating system. 


Meanwhile in the USA, two groups 
were taking the same network file 
system idea and looking at kernel so- 
lutions. We ended up with two sys- 
tems: RFS - Remote File Sharing and 
NFS - the Network File System. 


RFS 


RFS was based on work done by Peter 
Weinberger for the Eighth Edition of 
UNIX. It was implemented by a ‘File 
System Switch’. The File System Switch 
was originally designed to support dis- 
tinct physical file system types on the 
same system, while providing a con- 
sistent interface. The UNIX system call 
that pertain to files were intercepted i 
the top level of the kernel and passe 
into a service routine, one for each fil 
system type. RFS used this to pass thi 
UNIX system calls by RPC to a remote 
machine where they were executed by 
a server. The result was passed back 
via the normal system call interface to 
the user process. 


An aim of RFS was to support the ‘full 
UNIX file system semantics’. What 
does this mean? The operation of the 
basic system calls is obvious. In addi- 


tion, there are various side effects of 
the way that UNIX supports its files 
that are important to the way that many 
programs work. 


For example, when a process opens a 
file, it pulls the inode for the file into 
memory. The inode contains owner- 


RFS was a 
casualty of a 
marketing and 
dogma war 


ship data and the physical location of 
the file on the disk. In the in-memory 
copy, the kernel stores a reference 
count of how many processes have 
that file open. If the file is deleted, then 
its name is removed from the file sys- 
tem, but processes that have the file 
open can still read or write to it. The 
disk space will not be freed until the 
last process closes the file. 


Here’s another example. UNIX stores 
its devices in the file system. RFS 
wanted to allow the remote machine 
to have access to those devices so that 
the remote file system would behave 
exactly like one that is mounted on the 
local machine. 


RES, then, was designed to allow UNIX 
systems to share files. Like UNIX 
United, it intercepted the system calls 
and sent them to a server on the 
remote machine. The server actioned 
the system calls and returned results 
back to the local machine. It means 
that the server maintains information 
about the state of a file: whether it is 
open and where we are currently writ- 
ing or reading. 


If the server maintains state, then we 
have to worry about what happens if 
the client or the server suddenly dies. 
First, the knowledge of the death must 
be delivered to the other interested 
party. This is helped by the choice of 
the transport protocol used to commu- 
nicate between the machines. RFS uses 
a ‘virtual circuit’ to move its messages. 
A virtual circuit is a connection based 
protocol. Part of the protocol consists 
of handshakes and time-outs to check 
whether the circuit is still active. When 


one end dies, the other end knows 
within some short time. 


Recovery of state depends on whether 
the client or server is left alive. In the 
client, all processes waiting for file 
actions are woken and their system 
calls return with a special error number 
(so much for UNIX semantics). The 
server tries to undo any state that the 
crashed client has left. It dereferences 
in-memory inodes and loses any ex- 
tant file locks. 


Starting a connection is done by the 
mount command. A server ‘advertises’ 
in a name server what file trees can be 
accessed by external machines and 
gives each tree a symbolic name. A 
client quotes this symbolic name when 
making a mount request and its kernel 
initialises the file system switch for the 
mount point. 


RFS has not been popular even though 
it got many things right. When people 
talk about joining file systems together, 
you don’t immediately think about RFS. 
There are several reasons for this. First, 
it uses proprietary protocols rather than 
‘open’ ones. Second, it is limited for 
use between UNIX systems. Third, it 
was a casualty in a war that mixed 
marketing with religious dogma about 
stateless servers vs servers that held 
state. This jihad included the use of 
virtual circuits for connections vs data- 
grams. Fourth, it does not seem to have 
been upgraded in step with the file 
system. RFS is present on my Sun 
running SunOS 4.1.3 but does not sup- 
port symbolic links. A file system 
mounted using RFS will not be a full 
citizen of the file system world. The 
Solaris (System V, release 4) version of 
RFS now supports symbolic links. The 
Solaris documentation is much more 
positive about RFS and the system 
provides a way of managing both RFS 
and NES. 


NFS 


NFS is the acronym that springs to 
mind when people are talking about 
remote file systems. NFS emerged at 
much the same time as RFS. I well 
remember the ‘FS wars’ that dominated 
the Florence EUUG conference in 
1986, where RFS and NFS met head on. 


NFS had different design aims from the 
start. The most important goal was the 
provision of machine and operating 
system independence. This meant that 
the designers did not pick the UNIX 
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system call interface to form the basis 
of their network protocol. Instead they 
designed a ‘virtual file system’ layer 
and planted that in the kernel. The 
virtual file system layer runs on top of 
the ‘External Data Representation’, or 
XDR. This is a set of routines that allow 
canonical representation of C struc- 
tures, It means that you can put some 
complex binary data out onto the net- 
work and be sure that the recipient will 
see the same data. Sun made the XDR 
code available on Usenet in an effort 
to establish a de facto standard. RFS 
uses it when necessary. 


The NFS virtual file system is stateless. 
The server accepts an RPC request 
from the client, does the job, returns 
the result, and that’s it. It remembers 
nothing about the state of open files, 
it just performs the action in the trans- 
action and waits for more work. 


Originally, this was to help with crash 
recovery, If a client dies, then there is 
no server state, so nothing needs to be 
done to recover the physical file sys- 
tem. If a server dies, then you return 
results to the user process saying that 
the file has suddenly gone away and it 
should stop. 


The primitive NFS RPC operations sent 


by the client to the server are shown 
in Figure 1, All these operations refer- 
NAME ACTION 
null Do nothing, return a response 
Getattr Get file attributes 
setaddr Set file attributes 
lookup Get a file handle and attributes 
teadlink Read from a symbolic link 
read Read a number of bytes from a file 
write Write a number of bytes to a file 
cache Write the file cache 
create Create a file 
delete Delete a file 
rename Rename a file 
link Link toa file 
symlink Make a symbolic link 
mkdir Make a directory 
tmdir Remove a directory 
teaddir Geta directory listing 
statfs Get file system attributes 


Figure 1 - 
Primitive NFS RPC operations 
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ence a point in the server’s file system 
by using a magic value known as the 
‘file handle’. The contents of this are 
determined by the implementation. Sun 
use a file system id and a file number. 


As an illustration of how this works, 
consider a common operation: reading 
a file. When a UNIX process reads from 
a file it will use the open system call 
to open it, several read system calls 
to get the data and will finally call 
close to signal that it has finished. 
The open system call will be translated 
into an NFS look-up operation to ob- 
tain the file handle of the needed file. 
NFS does not handle slashes in file 
names - it’s necessary to look-up one 
path name component at a time, so a 
standard open call can take a number 
of look-up iterations. 


When the read system call is invoked 
from the UNIX process, the kernel will 
use the NFS read operation to obtain 
data from the file. The read operation 
will include the file handle that was 
returned by the previous look-up call. 
Other parameters to the read are the 
offset from the start of the file and the 
size of the chunk that is to be moved. 
The stateless server means that it’s up 
to the client to remember where it is 
in the file and issue the appropriate 
RPC calls to pull the data in. 


Finally, the UNIX program will invoke 
the close system call. Nothing is sent 
to the server, it’s stateless and knows 
nothing about the UNIX idea of ‘the 
open file’, 


As far as possible, things are designed 
so that is doesn’t matter if an operation 
is redone. This is because a client 
expects to retry a request if it gets no 
response from the server. Generally, 
NFS is implemented using a datagram 
protocol (UDP, Universal Datagram 
Protocol) and this is guaranteed to be 
unreliable. Any system along the route 
that the datagram packet travels is 
allowed to throw it away. Packets can 
be discarded because of congestion 
and a so lack of server response can 
mean more than just the server is 
down. 


Given that the client can send a request 
several times, it’s possible for the serv- 
er to see the same request more than 
once. Since it is stateless, it will just do 
the operation again and send the reply. 
This is OK for many operations but has 
problems for creation and deletion of 
files and directories. 


UNIX 


Stateless operation creates the need to 
ensure that any NFS RPC operation that 
changes the disk must make it onto the 
disk surface before the server returns 
a result to the calling system. If this did 
not happen, there would be a need for 
data recovery if the server crashes. 
Ensuring that the data is physically on 
the disk means that the file is in a 
known state, and the client can survive 
a server crash by simply waiting for it 
to come up again. However, it does 
means that NFS operations make the 
disk work very hard. There are hard- 
ware solutions to help with this. 


When the client wants to start talking 
to a server, it needs a file handle of the 
remote file system. This is handled by 
the mount command in a similar fash- 
ion to RFS. 


Pushing the whole problem of mount- 
ing the file system into a separate 
program has a great benefit. It allows 
the mount process to be tailored de- 
pending on the type of system that is 
wishing to be a client. For example, we 
want to impose some security checks 
when PC users connect with PC-NFS. 
A mount from a PC will go to a special 
mount program that asks the user for 
a login name and password before 
permitting mounts to take place. This 
ensures that the UNIX system enforces 
its idea of file security and access 
permissions on the unconstrained and 
unprotected PC. 


Another protocol is used to handle file 
locking. Early NFS implementations 
did not support locking, Sun finally 
generated the lockd demon and its 
associated locking protocol. It runs on 
the machine that is local to the file 
being locked. There’s a problem here 
when a client locks a file and then dies. 
The file stays locked until the client 
recovers and tells lockd to reset the 
locks. It is an area where using a virtual 
circuit would be much saner, because 
lockd could detect that the client had 
died and do the right thing. 


NFS works and is fast. There are a 
several rough edges. When a server 
dies, it can hang any program that is 
dealing with files on that server. This 
is because the lowest levels of the file 
reading mechanism are trying to be- 
have as if the remote file really is local. 
If a process is executing a write system 
call, it will be put to sleep until the call 
finishes. This sleep cannot be inter- 
rupted by a signal, so keyboard inter- 
rupt (perhaps Control-C) from the user 
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cannot cause problems with the local 
disk state while the write is taking 
place. 


This is fine for a local disk, where 
transactions happen very quickly and 
always finish. It is less fine if the file is 
remote and the server crashes. Your 
process has initiated a write to the 
remote machine but has not had a 
reply. It will keep retrying the write 
until the server returns. Meanwhile, 
you know the server is down and 
pound on the Control-C keys to at- 
tempt to kill your process. Nothing 
happens. The process is stuck in a 
non-interruptable wait. There is a way 
round this, you tell the mount process 
to do a ‘soft’ mount. Then any pro- 
grams can be interrupted in mid sys- 
tem call by Control-C. It’s possible for 
this to have a deleterious effect on the 
file at the other end. 


NFS has never handled mapping of 
numeric user id’s between systems. It 
demands that the same password file 
lives on all machines. Recall that UNIX 
maps your login name into a numeric 
value via the password file - a wid. RFS 
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and UNIX United recognised that the 
notion of the universal uid space is not 
terribly practical and provide a way of 
equating uids on different machines. 
Sun chose another route, providing the 
Network Information Service (NIS). NIS 
used to be called ‘Yellow Pages’ until 
British Telecom became belligerent 
about its trade-mark. NIS is not a dis- 
tributed database, but a way of making 
the password look-up on one machine 
go off and interrogate another. This is 
fine until your password server crashes, 
and the whole network dies because 
it cannot get passwords. Some people 
think NIS is the best thing since sliced 
bread, and other people decry its use. 


Where are we now? 


NFS is a fact of life. We all adapt to its 
problems and live with the various 
bodges that have been created to make 
things work. PC-NFS is very popular. 
RFS is not dead. 


I like the notion of network file sys- 
tems. I was pleased to buy an MS-DOS 
ISO-9660 CD-ROM, throw it into the 
CD reader on my Sun, export the file 


system and access it on my MS-DOS 
machine as drive L: using PC-NEFS. I 
am less enamoured when it is time to 
take a dump of the disk on MS-DOS 
machine and I cannot directly access 
the QIC-150 tape drive on my BSD/386 
box because NFS does not permit ac- 
cess to remote devices. 


However, networked file systems make 
many things possible that would oth- 
erwise be difficult. The ability to share 
files on different machines means that 
you have to buy fewer physical disks. 
It has made large networks of disk-less 
workstations a practical reality. Its in- 
fluence on the world of workstation 
based computing has been immense. 


CEXE) 


Peter Collinson is a freelance consult- 
ant specialising in UNIX. He can be 
reached electronically as pc@hill- 
side.co.uk (although your mailer 
might be happier to put the address the 
other way round) or by phone on 0227 
761824, 


22 Ey 
24 25 
26 27 


90 .EXE Magazine, Vol 8, Issue 2, July 1993 


LIA|TIE|Nicly MMplelcliiMiaie 
EMEA MoMoMs.Mulo 
A|T|LIA|S [MUN] D/E| RIFIL|O|w 
OM ERR ci Ten 
LIN |G lo}T MG ul iD el Lii inte 
Nh ff Gt 5 
GIR|A|M/M/A Rima! ol Bl ul iinis 
Pe ufiN 
A PIH/ A S| 1JA MS I /L{1]Cloin 
R Uv Kr Bo 
ClOLILJE|c|T|O REM S|WIE| AT 
HER BoP a ive 
LIDJEIN| TIIIClA LEMO ILI Ell ic 
vilic a0 Dh 
E|N|H|A|N/C/E gS |W E| A|T/E/D 


When you look inside... 


You'll see that it's a real 
= of an idea. 


We think you should know exactly what you're friendly utilities make it a snap to develop the 
buying. That's why we've made sure you can look aplieme that's just right for your pono And 
inside DeadLock 3. f DeadLock 3 is so secure, we're even 

DeadLock 3 gives you the best software ready to give you the complete sources*. 
protection available. Our unique Contact us today and find out about 
combination of custom-designed ASIC DeadLock 3, We've got a demo kit 
and proven mathematical algorithm lets waiting for you - complete with utilities, 
us safeguard your product without hiding samples and full documentation. There's 
anything. And that means you stayin absolutely no obligation. We just want 
complete control.DeadLock 3 protection ~ you to look inside and see what a pearl 
is dead easy to implement too. Our user- of an idea it is. 


Deadlocks 3" is real protection 
BL Computer Security Limited 


101 nation Lane, Finchley, London N3 3SH 
PO Box 2543, London N3 3UA, United Kingdom 
Fax: 081 346 2672 Tel: 081 343 0734 


*Sources available in compliance with terms specified by the manufacturer 


> CIRCLE NO. 942 


(CREATIVE COMMUNICATIONS. 


LL 


Books 


Tools of the trade - a compendium of languages and DIY utilities. 


Imperatives & Others 


The prospect of making a forced 
exit from my job prompted me to draft 
a CV. I began with a working knowl- 
edge of Modula-2 and a whizzo text 
editor (written, incidentally, in 
Modula-2) under my belt...Alas, no 
potential employer would consider 
anyone without five years solid C/C++ 
- with typecast scars to prove it. Dwell- 
ing on this miserable situation it oc- 
curred to me that: ‘Although two 
languages may seem to be superficially very different, i 
often have many more similarities than differences.’ Actually, 
it didn’t occur to me at all: the quote is take from Comparative 
Programming Languages by Leslie Wilson and Robert Clark. 

The authors discuss issues such as the relative merits of 
early/late binding of variables, the different methods of passing 
parameters to functions and exception handling by presenting 
the methods employed in several languages side-by-side. 
Common traps such as the different behaviour of the FOR 
statement are also covered. I must admit to being startled by 
the discovery that, while the value of the loop counter variable 
is valid outside a for loop in bad-boy C, goody-two-shoes 
Pascal leaves it in an undetermined state. 

The object-oriented approach to programming is compared 
to Ada’s mechanism for data abstraction. The authors draw 
parallels from the C++ and Eiffel camps. In addition, Smalltalk 
gets a brief mention, although its historical significance is 
overlooked. Apologies to Xerox-Parc. 

Wake up call to lambda calculus addicts! This book doesn’t 
just cover the family of imperative languages. It looks at 
functional programming too. I can recollect sad (wasted) 
college days labouring over the unreadability of LISP. Don’t 
get me wrong. I do appreciate the power of these languages. 
The book’s introduction to ML, a new, easy to read, statically 
typed language has rekindled my enthusiasm for this type of 
computing. 

Other types of programming covered include: logic pro- 
gramming in Prolog and concurrent programming in Ada, 
Occam and C (using UNIX pipelining). 

Instead of dedicating a chapter to each language, Compara- 
tive Programming Languages develops and builds upon com- 
mon principles. What this means to the reader is that it isn’t 
possible to glean a working knowledge of a given language 
from reading a single chapter. However, the material is given 
in a way which makes it easier to translate from one language 
to another. 


Comparative 
Programming 
Languages 


Leslie B.Wilson 
Robert G.Clark 
% 


Title: Comparative Programming Languages Pages: 374 
Authors: Leslie B Wison & Robert G Clark Price: £21.95 
Publisher: Addison-Wesley ISBN: 0-201-56885-3 


Books 


Soft Spanners 


Under DOS, when an off-the-shelf 
package lacks some level of function- 
ality, a programmer must choose be- 
tween writing a standalone program 
or buying a new package to perform 
the job in question. UNIX program- 
mers have another option: they can 
string commands together, using a 
technique called pipelining, to 
achieve the desired result (in theory). 
In his book, Building Custom Software 
Tools and Libraries, Martin Stitt looks at the various methods 
employed in writing utility software for MS-DOS. 

But this isn’t a book about producing specific utilities. The 
author concentrates instead on exposing the techniques in- 
volved in writing these tools. When should one opt for a TSR 
or device driver in preference to a standalone utility? What are 
the pros and cons of using UNIX-style pipelining for filters. 

Code reuse is an important theme throughout the book. 
Along with the obligatory discussion of object libraries, the 
author side-tracks with a look at techniques involving source 
code include files, TSR libraries and ending with a brief 
overview of the DLL mechanism. An in-depth review of how 
global variables are linked in C and assembler, in conjunction 
with an explanation of the object file format, goes some way 
to revealing the mysteries of the linker. 

On the question of writing TSRs and device drivers: there’s 
a good assembler implementation of stack swapping (neces- 
sary for reéntrant code) and a utility for generating correctly 
ordered segments when mixing assembler with a high-level 
language. Segments must be ordered such that the resident 
portion of the TSR is kept separate from the initialisation part. 

Other highlights include: an in-depth look at how function 
hooks can be added to a keyboard input routine to achieve 
multi-threading and mouse emulation; parsing command-line 
arguments and an example of file and directory searching. 

Throughout the book, code is given in C, assembler and 
pseudocode (where appropriate). Although primarily aimed at 
C and assembler programmers, thanks to the peusdocode 
listings, those readers from other programming backgrounds 
should find little difficulty adapting the routines presented. 

Building Custom Software Tools And Libraries attempts to 
cover several books worth of advanced programming tech- 
niques in 300 pages. As such, there are some topic areas which 
have been given less than complete coverage, rendering it 
unsuitable as a bookshelf reference. But as an insight into 
writing such software, it is an excellent buy. 
cs 


BUILDING. 
‘CUSTOM 
SOFTWARE 


TOOLS AND 
LIBRARIES 
ol 


Title: Building Custom Software Tools and Libraries Pages: 272 
Author: Martin Stitt Price; £23.50 
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By weaving our own unique brand of sorcery in the 
rapidly expanding field of data communications, Madge 
Networks has become the acknowledged World Leader in 
Token Ring LAN technology. 


Token Ring is the choice of major companies with large 
everyday data communications needs. Our products are 
the hardware and software required to interconnect PCs 
using all the popular network operating systems, plus 


Founded in 1986, our technological edge combined 
with strong presence in major world markets has allowed 
us to double in size each year. Turnover in 1992 was in 


To underpin our technological supremacy and sustain 


ASH ASSOCIATES 


We Specialise in the Recruitment of Software Design Engineers for 
Real-Time Applications. We have clients throughout the South East seeking 
engineers with experience of: Computer Graphics, Image and Signal 
Processing, Virtual Reality, Multi-Media and Interactive Training Systems, 
Real-Time Control and Instrumentation, Mathematical Modelling, 
Communications Systems and Network Design. 


LATEST REAL TIME OPPORTUNITIES IN THE SOUTH EAST 


Oxon: — Software Engineers, Software House, Data Security; C, Windows, Anti-Virus £25K 
Hants: — Senior Software Engineer, Control Systems; C, C++, Windows, Unix £25K 
Sussex: Computer Science Graduates, Interactive Multi-Media; C,C++,Windows  £18K 
Surrey; — Software Engineers, Telecoms, Real Time Control; C, 68K, Windows £20K 
Surrey: — Software Security Consultants; Multi-Language/Systems & Methods £30K 
E London: PC Analyst Programmers, International Securities; C, C++, Windows, Unix £23K 


WE ALWAYS HAVE A REAL NEED FOR ENGINEERS WITH 
ANY OF THE FOLLOWING SKILLS 


UN | SOS | KERNELS | 
ASSEMBLERS 
NETWORKS | MULTI-TASKING | TCPIIP 
INTERFACING/PORTING | METHODOLOGIESIYOURDON | X25 | 
LMisual Basic | visuaLcrs | os2 | macine | Rogorics | cu 
COMPILERS | VME | DATABASES | TELECOMMUNICATIONS | VIDEO | ost | 


Call us today to discuss your next move, Ron Cook or James Hunt. 
TEL: (0425) 475480 or FAX: (0425) 480807 or Post your CV to Ash Associates, 
Recruitment Consultants, 3 Pipers Ash, Ringwood, Hants, BH24 1UF 


LASH) associates 


Lord of the Rings 
seeks wizards. 


advanced software to manage large distributed networks. 


excess of £40m, the majority of this from overseas business, 


our growth into new fields of networking we need further 
highly gifted graduate Designers, Developers and Technical 
Support staff at all levels, with backgrounds in systems 
software and/or digital electronics. 


You will be joining an exceptional group of strongly 
motivated individuals in an informal atmosphere with a 
high degree of personal responsibility. Needless to say, 
your contribution to our success will be very well rewarded. 


If you have the wizardry to add 
your own magic to a high tech success 
story, write to Fiona Woods at Madge 
Networks Ltd, 100 Lodge Lane, 
Chalfont St. Giles, Bucks HP8 4AH, or 
telephone her on 0494 765651. 


The Ring Leader 


Sy SOFTWARE DEVELOPERS 


Leading-edge telecomms products 
415,000 - £30,000 West Midlands 


Few companies can deliver the kind of involvement in 
ground-breaking projects that these opportunities present. 

That’s because our client, one ofthe major forces in the international 
communications industry, is investing now in the second phase of a 
major state-of-the-art product development initiative. 

For you, this means an exciting new focus for your blend of 
creative insight and practical experience — supporting the company's 
aggressive drive to exploit new technologies and to open up new 
markets throughout Europe and North America, 

We are looking for Software Engineers at several levels, with 
hands-on experience in at least two of the technical areas 
listed below. If you have the right skills and enthusiasm, our client 


promises a highly attractive package which includes relocation ifappropriate. 


@ SDH @ ISDN protocols 

@ OSI (ISO, CCITT, X.700) @ DASS2 

@ CMIP/CMIS Kilo/MegaStream 

@ UNIX/C/C++ Data Acquisition (& controllers) 
@ Retix Stack Emulators 

@ GDMO/ASN.1 SSADM/RTSAD 

e@ OOD/OOA YOURDON/Teamwork 


Please contact Neil Mehta or Tracey Laing on 0344 860919. Or 
send your CV, quoting reference EX6067 and a daytime telephone 
number in the strictest confidence, to the TSI Group, Columbia 
Centre, Market Street, Bracknell, Berkshire RG12 1PA. 
Facsimile: 0344 860581. 


TSI Group 


QUALITY IN SERVICE 


-EXE RECRUITMENT ADVERTISING - Call Marc Warren on 081 994 6477 tl 


EXE | 


Oa DEVELOPERS’ MAGAZINE 


MANAGEMENT 


M*A*G*A*Z*I°N 


CIRCULATION / SUBSCRIPTIONS MANAGER 


Process Communications is a West London based publisher of specialist software development journals: 
.EXE, Basic Magazine and Software Management. All our titles are subscription only. 


We seek an enthusiast to take over our Subscriptions department. The job involves devising promotional 


campaigns for the magazines, copy writing, acquisition of lists, management of our subscriptions database, 
liaison with mailing houses and meeting lots of deadlines. 


You will be joining a young and exciting team who will ensure your job is hell but fun! 


Our basic requirements are for somebody with relevant technical sales and marketing experience plus a 
solid knowledge of the use of PC's and considerable flexibility. Demonstrable xBASE skills and (inevitably) 


a sense of humour are almost as important. 
Salary £15-£18k, dependent on experience. 


Please write with CV to: Sandra Inniss-Palmer, Process Communications Ltd 
10 Barley Mow Passage, Chiswick, London W4 4PH - Or Fax to: 081 995 7775 


Paralog Systems International Ltd, purveyors of fine full-text retrieval database 
systems, are looking for two new people to join their UK team. 


User-friendly techie 


This is a customer-oriented, technical support role working with the 
TRIPfamily text database products currently running on VAX/VMS and 
a range of UNIX servers to Windows client. The job will involve 
application development, liaison with our R & D teams'in Germany and 
the USA, consultancy work at customer sites and the preparation and 
presentation of training courses. 


We are looking for a well presented Computer Science graduate (or 
similar) with several years of C programming, UNIX and Windows 
experience. Prior experience with databases and networks would clearly 
be an advantage. Age 25+ 


Pre-sales supporter 


Working alongside our small but perfectly formed sales team, we 
require an individual to prepare and present demonstrations for existing 
and prospective customers, including assisting in preparing proposals and 
responses to enquiries. This will involve some travel in the UK and 
Ireland and attendance at exhibitions. 


You will be the product of a sound technical education, with some C 
programming experience, but you will also be outgoing, very presentable 
and have excellent verbal and written communication skills. Age mid 
20s-ish. 


Paralog Systems International Ltd is a part of the PSI group of companies, 
based in Germany, with worldwide turnover in excess of £40 million. It offers 
attractive salaries and a good range of benefits to its employees. 


Please apply in writing to: 
Miss Ann-Marie Korth 


Paralog Systems International Ltd _== 

‘aralog Systems International ——— 

Clerks Court Paralog 
18-20 Farringdon Lane Systems 
London ECIR 3AU geen Nternational 


No agencies, please 


WEST 
YORKSHIRE 


Senior Analyst Programmer with ‘C' or ‘C++' 
experience combined with MS Windows 
or Graphics programming. 


Informix 4GL Analyst Programmer / Support 
under Unix working on housing 
management applications 


to £20,000 


£14,000 


Senior Electronics £15 to £25,000 
design engineer dependant on experience 
PC & Novell Support £12,000 
Dataease experienced Programmer to £13,000 
PC/Support/Installation/Trainer £12,000 
Dataflex Analyst £14,000 
Programmers and Senior £18,000 


FOR YOU NEXT CAREER MOVE 
AROUND WEST YORKSHIRE 


Telephone Vincent Atherton on Leeds 
(0532) 504560 or write to: 


AIREDALE RECRUITMENT 


Realtex House, Micklefield Lane, 
Rawdon, Leeds, LS19 6AX 


AIREDALE 
RECRUITMENT 


EXE RECRUITMENT ADVERTISING - Call Marc Warren on 081 994 6477 


Associate Consultants 


We are QA Training Limited, a highly successful computer systems training and consultancy company. Formed in 1985, 
QA now has an enviable reputation as a world leader in computer systems training, with an international client base 
plus the support of many manufacturers. 


We are seeking to expand our team of self employed Associate Consultants who work with us on an ‘as needs’ basis in delivering 
training courses in specific technical areas. We believe that our relationship with our Associates is a unique one, as our aim is 
always to develop a long term and on-going association. 


Current opportunities exist in the following skills areas: 


C/Windows Programming Specialist Object Technology Consultant 


You should have extensive experience of programming in You should have a good working knowledge of design 
Windows and C (at least a minimum of 3 years). The methodologies and a minimum of 3 years OOT experience. 
following technical skills would also be useful: The following technical skills would also be useful: 

= Exposure to design methodology =m C++ programming 

= Knowledge of Presentation Manager and/or OS/2 ® Case Tools 

m Real work development experience m= OO Development Methods (Rumbaugh) 

m Pascal/Basic programming 

= Knowledge of multitasking systems 


To apply for any of the above opportunities or for further details, call Alicia Smith on 0285 655888, or forward a detailed 
Curriculum Vitae, quoting the relevant title to: 
Alicia Smith, QA Training Limited, Cecily Hill Castle, Cirencester, Gloucestershire GL7 2EF 


e NO AGENCIES PLEASE e 


ALL DEVELOPMENT SOFTWARE ENGINEERS. 


@ We currently have some more interesting roles available for technically together types. 


@ Porting crazy? We have lots of client/server NT jobs - so dust off your Beta version 
and give us your C.V. 


C, C++ & Windows (SDK & X) as always - plus XVT & Motif abilities wouldn't go amiss. 
Ingres / Gupta / Oracle SQL Developer - if you have G.U.| ability all the better - spiffing salary. 
Oracle financial or RPT skills. 

Unix Telecoms/ Networking with C/ NFS/ or SUNOS - Yippee 

Microfocus COBOL - Workbench - Dialog - C - Unix or DOS - Unbelievable 


Should any of the above mixes be of interest - call! 
If not, call anyway. We might have something right up your street. 


Ae. DURNAN LINSTEAD & ASSOCIATES 


32 ST JAMES’S STREET 
LONDON SW1A 1HT 


For any further information and applications, please call Mike Dearing on 
071 321 2277 (office), or 081 854 0078 (Evenings/Weekends), or alternatively, fax your C.V. on 071 925 2150 


ADVERTISERS 


INDEX 


ADVERTISER PRODUCT/SERVICE CIRCLE PAGE | ADVERTISER PRODUCT/SERVICE CIRCLE PAGE 
ABC Software Help Builder 910 31 Nu Mega Debugging Tools 9700 AN 
Basic Magazine Subscription 911 33 OS/2 Solution Centre 0S/2 Software 915 37 
Bits per Second Graphics Tools 919 45 POET POET/Object Oriented Database 928 67 
BL Computer Security Software Security Dongle 942 91 Polyhedron Software Programmers Utility 935 79 
Blink Inc. Fast Linker 938 81 Premia Programming Tools 924 51 
Borland Development Tools 893 § QA Training 943 IBC 
Brent Communications MAX Copy Protection 897 14 QBS II Clipper 916 38/89 
Citadel Software Comms Library 914 35 Quantec Development Too! Kit 930 70 
Computer Associates Application Dev. Tools 926 53 Rainbow Technologies Security Products 900 17 
Contemporary Software BASIC Database 902 24 Readmar Version Control 895 9 
CTL Copy Protection hardware 9083 Real Techniques & Methods CASE Tools 891 IFC 
Deepak Sareen Assoc Project Management 933 74/75 | Richfords Clipper Training 937.79 
DES Software Protection 932 ua) Richfords Visual C++ Training 921 47 
ECUG European C++ Conference 912 33 Ridgeway Press Computer Manuals & Printing 945 47 
Evesham Micros Visual Basic Add-on 940 85 Salford Software Fortran for DOS & UNIX 925. 52 
EXE Disks 905 a7 Softlok Piracy Protection 939 «83 
Expotech Development Tools 870/890 55/63 | Software Security Security Dongles 906 29 
Great Western Instruments Software Design Tools 923 50 System Science Programming Tools 904 25 
Grey Matter Programming Tools 892 3 System Science Version Control 941 890 
Hypersoft Programming Tools 896 11 SystemStar SoftTools Ltd | Programming Tools 894 7 
Inmark C++ Application Framework 944 OBC | SystemStar SoftTools Ltd !l Help Builder 901 19 
Inst. Analysts/Progmrs Institute 909 31 SystemStar SoftTools Ltd Ill Flowchart Builder 927 54 
Intasoft Version Control 918 43 Trevan Design Bulletin Board 920 47 
Magnifeye Software Protection Device 922 49 User Friendly Software Copy Contro 934 78 
Microcosm Copy Control 936 79 Wigmore Computer Solutions — Software Directory 898 a 
Microsoft Press Books Specialists 913 33 Wigmore Computer Solutions — Software Directory 907 31 
Microsoft UK Visual C++ Zinc GUI Library 899 13 


8T0B Larn yasel programmin! 


Once a decade, a single product redefines the parameters of programming practice. That moment has now arrived. 
From our extensive software laboratory, located high above Chiswick on the 25th floor of the .EXE Towers, comes a new 
concept in programming languages. 


The Background 

You will recall that Kernighan and Ritchie developed the C 
language from BPCL to simplify the construction of the UNIX 
operating system. Our language was developed one evening from 
ten pints of brown ale. The idea was to distract the author from 
a strong feeling of nausea that was afflicting her (didn’t work). 
From these humble origins, the product has matured to the point 
where we feel able to release it onto an unsuspecting world. 


The Language 

GEORDIE - the name is an acronym for ‘Gulping Excessively 
Often Ruins Decent Indian Edibles’, in memory of another 
incident the night the language was born - is surely the most 
versatile and powerful of programming languages. It is adaptable 
to nearly all applications from authoring to astronomy, and from 
systems to simulation. Like BASIC it’s easy to learn, like Ada it 
has facilities to handle interrupts and multi-tasking events, and 
like FORTRAN it has seven letters in its name. Consider this 
fragment of pseudo code, part of a real time fire-prevention 
system: 

IF fire detected THEN 

DO take-fire-prevention-action 


Here is the same fragment of code in GEORDIE: 
If ya ganna smork ya tab in ear, 
ah’ll belt ya from ear to Geeatsheed, mun 


Like COBOL, GEORDIE was designed to be as similar to natural 
language as possible. We have made very few concessions to the 
compiler writers, although the symbol mun is used as a statement 


(Thanks to the Tait family for programming help.) 


separator - equivalent to the semicolon in Pascal. Nobody would 
really speak GEORDIE, but we think it’s a darn close-run thing! 


The Competitors 

GEORDIE beats its rivals hands down. Consider this pseudo code: 
FOR each item in Shopping-List array 

Do print item 


Here is the same program coded in Cockney Rhyming BASIC: 
10 FOR MINCEPIE = 1 TO MAXLIST 

20 MURRAY MINT SLISTS$ (TI) 

30 SORELY VEXED I 


Finally, here it is in GEORDIE: 
Tell us wha ya gerrin in for dinna, mun 


Need we say more? 


The Package 

You get a lot more than a simple compiler with GEORDIE. There's 
an interpreter so that applications can be developed interactively. 
Forget obsolete prompts like ‘ok’ and ‘READY’, when you see the 
line ‘What fettle, petal?’ you know you’re working with the market 
leader. Also free with the compiler comes a complete program- 
mer’s environment - and we aren’t talking about a text editor and 
a manky MAKE utility. GEORDIE is bundled with a copy of Scott 
Dobson’s definitive work ‘Larn Yasel Geordie’, a black and white 
scarf and a couple of crates of the aforementioned electric soup. 


To get your copy of GEORDIE, send a cheque for a lot of money 
to V STOB, c/o .EXE, Chiswick. GEORDIE. It’s champion, man. 


EXE] 


This is a second in a short series of Stob repeats. We thought it was rather appropriate to our cover matter! 
It first appeared in December 1988. 
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TRAINING AND CONSULT IN 


Shall up wit] 


the leaders 


Computer professionals know that QA provides the best technical = 2—ainir 
and consulting, giving them skills in new technologies and keeping; = Hnemt 
to-date with the latest developments. 


UNIX 
QA can help you make best use of Unix workstations or servers with Fundament== HE = , 
Administration, Networking and Programming courses. 
WINDOWS AND WINDOWS NT 
QA’s breadth and experience in Windows and Windows NT is unrivalled, with ¢ <>» === wses fo 
programmers, support staff and users, QA is a Microsoft Systems ATC. 
OS/2 
Complete coverage of OS/2 including programming and support, the extended se =— —&~ ices 
components, OS/2 LANS and even courses for first time users of the Workplace S Hem ell. 
NETWORKS 
From planning to implementation, support to programming, QA has extensive ta~ =a St waxing in 
Novell NetWare (NAEC), Microsoft LAN Manager, IBM OS/2 LAN Server and UJ 2=—m x 
networking. Datacommunications training too. 
EMAIL AND GROUPWARE 
QA will teach you how to provide an efficient service for users of Lotus cc: Mi == am EB, 
Microsoft Mail, and how to use the powerful groupware products; Lotus N@ @® <=s and 
Microsoft Windows for Workgroups. QA is a training centre for Lotus CL.e> — 
LANGUAGES 
QA is the UK’s premier C and C++ training organisation. We have taug; ox a 
thousands of delegates good, structured, efficient C and C++ program 2m St aig sty! 
OBJECT-ORIENTED TECIINOLOGY 
From introductory courses and management overviews to sophistic == = <d 
analysis and design, including Rumbaugh OMT, QA provides a comm 9g > lete 
education in the principles and practice of Object Technology. 
SUPPORT 
Manage PCs and workstations better with hardware and softtwa =—<«= supp 
training for DOS, Windows, OS/2 and Unix. 
DATABASES and CLIENT-SERVER 
The most up-to-date training in database, SQL and client-server technology. ME a <> x-osoft 
Access, SQL Server and IBM DB2/2 support and programming are included. 


We are dedicated to helping our clients get the most from their computer investment 
through quality training and consulting. 

For more information, call Gordon Ritchie on 0285 655888, or complete and return 
the' coupon today. 


Mail to QA Training, Cecily Hill Castle, Cirencester, 


Gloucestershire, GL7 2EF. UK. Name 
EXE 07193 
Job Title 
Tick here for full details. 
Gompany 
TRAINING LJ osi2 \_] Email/Groupware Address 
CONSULTING Networks Support 
Unix Languages Client-Server/Databases Postcode 
Windows Object-Oriented Telephone 
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BARELY POTABLE 


Ever get the feeling that OWL stands for “Outdated Windows Library”? That MFC really means 
“Microsoft Frustration Classes”? If so, toss them out and join the thousands of programmers who 


have discovered a better application framework: zApp. 


In an industry that’s always changing, the future belongs to programs that can change with it. 
That’s why we’ve developed zApp, the industry leading C++ GUI class library. zApp allows you 
to support all the platforms you need with just one set of source code. You simply make calls to 
zApp classes, without worrying about the platform’s specific API, and zApp does the rest. 


zApp is also the most full featured application framework available. Giving you more classes 
than OWL and MEC combined, zApp sports an unmatched list of capabilities for creating first- 
class applications quickly and easily. That’s one of the reasons why Windows Tech Journal wrote 
“cApp is simply the best designed application framework on the market. If C++ is your language 
of choice, then you should be using zApp. Period”. 


Finally, zApp is easy to use. By providing an intuitive class structure and plenty of example pro- 
grams, zApp allows you to produce more code faster, making it ideal for C++ programmers of all 
levels. With over 1200 pages of documentation, including extensive tutorials and demos, as well 
as free technical support, you know you'll never be left hanging. 


So pick up the phone now and call (0992) 500919 and ask for our free demo disk, and get a 
glimpse of what the future has to offer. 


Data Entry Classes - includes Text, © Advanced Message Handling 


Pp 


Source Code Included 

*No Runtime Royalties 

Compatibility with Most 
Major Compiler 

©Documentation - including over 65 
sample programs, tutorials and 880 
page Programmers Reference 

*Over 35 Window Classes — including 
application, Dialog, MDI, all Standard 
Controls, Common Dialogs, and 
access to custom controls 


Picture String, Numeric, Date, Time, 
Radio Group, Checkbox and List 
Fields 
Graphics classes — including 
Windows, Bitmap, Printer, Fonts, 
Pens, Brushes, Bitmaps, Colors, and 
Regions, Printer and Font enumeration 
Object Persistence — Using a streams 
interface, easily store objects and 
other data to disk and retrieve them 
Advanced MDI Support” 
Robust and Efficient 
Memory Management 


e Advanced Debugging Support — traps 
many common programming errors - 
includes a powerful assert system. 

Dynamic Sizers — Sizers provide auto- 
mated window and graphical object 
layout management 

* Advanced Scrolling Classes 

Menus - including standard, system, 
and popup 

¢Full DDE Support 

¢Much, much more 
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